API REST · v1

API oggetti DayZ

L'intero database oggetti in JSON – utilizzabile gratuitamente con una chiave API personale. Per bot Discord, strumenti server, overlay e i tuoi progetti.

Accesso e fair use

Tutti gli endpoint /api/v1 richiedono una chiave API gratuita – tiene fuori gli abusi e rende possibili limiti equi. Nessun abbonamento necessario.

Accedi con Discord – l'account è gratuito.
Crea una chiave API gratuita nelle impostazioni.
Crea una chiave API e inviala con ogni richiesta.

# Empfohlen / recommended
curl -H "Authorization: Bearer dzp_YOUR_KEY" \
  "https://dzpage.com/api/v1/items?q=akm"

# Alternative
curl -H "X-Api-Key: dzp_YOUR_KEY" "https://dzpage.com/api/v1/meta"

Tieni segreta la tua chiave: chiama l'API dal tuo server, bot o backend – chiunque abbia la chiave consuma la tua quota. Puoi revocare una chiave in qualsiasi momento nelle impostazioni e crearne una nuova; quella vecchia smette subito di funzionare.

Serve più capacità? Abbonamento sostenitore opzionale

Con 3,99 €/mese sostieni i costi del server e il tuo limite sale da 60 a 300 richieste al minuto. Disdicibile ogni mese nel portale clienti.

I dati di gioco restano liberamente accessibili a tutti – l'abbonamento sostenitore paga solo capacità server (un limite più alto), mai i dati. DayZ e i suoi dati appartengono a Bohemia Interactive a.s.

Gestisci abbonamento e chiavi

Chiave API obbligatoria

Invia la chiave come header «Authorization: Bearer» o «X-Api-Key» a ogni richiesta.

60 → 300 richieste/min

Gratis: 60 richieste al minuto per chiave. Con l'abbonamento sostenitore opzionale: 300/min. Ogni risposta porta header X-RateLimit, incl. X-RateLimit-Tier.

Dati reali di gioco

Estratti direttamente dalle config di DayZ, aggiornati dopo ogni patch.

GET`/api/v1/items`

Cerca e filtra oggetti (paginato)

Parametro	Descrizione
q	Ricerca in nome e nome classe (fuzzy)
cat	Categoria, es. Weapon, Food / Drink, Ammo
tier	Tier del loot: Tier1 – Tier4 o Unique
sort	name (predefinito), damage, rpm o weight
page	Pagina, da 1
limit	Risultati per pagina, 1–100 (predefinito 48)
icons	1 = solo oggetti con icona
lang	Lingua del campo name: en, de, fr, es, it (predefinito en)

curl -H "Authorization: Bearer dzp_YOUR_KEY" \
  "https://dzpage.com/api/v1/items?q=akm&limit=5&lang=it"

{
  "meta": { "total": 12, "page": 1, "pages": 3, "limit": 5 },
  "items": [
    {
      "class_name": "AKM",
      "slug": "akm",
      "name": "KA-M",
      "category": "Weapon",
      "has_icon": true,
      "weight": 2140,
      "size_w": 8, "size_h": 3,
      "loot_tiers": ["Tier4"],
      "damage": 9.5,
      "icon": "https://dzpage.com/icons/full/AKM.png",
      "icon_thumb": "https://dzpage.com/icons/thumb/AKM.webp",
      "url": "https://dzpage.com/it/items/akm"
    }
  ]
}

GET`/api/v1/items/{class_name}`

Singolo oggetto con tutti i dettagli

Accetta nomi classe (senza distinzione maiuscole) o slug. Restituisce tutti i campi: statistiche armi, munizioni, caricatori, accessori, dati loot, edifici di spawn, ricette, tutti i nomi tradotti e i dati grezzi completi della config di gioco.

curl -H "Authorization: Bearer dzp_YOUR_KEY" "https://dzpage.com/api/v1/items/AKM?lang=it"

// JavaScript (Node.js, Discord-Bot, …)
const res = await fetch("https://dzpage.com/api/v1/items/AKM", {
  headers: { Authorization: "Bearer " + process.env.DZPAGE_API_KEY },
});
const { item } = await res.json();
console.log(item.names.it, item.weapon_stats.rpm_full_auto);

GET`/api/v1/categories`

Tutte le categorie con numero di oggetti

curl -H "Authorization: Bearer dzp_YOUR_KEY" "https://dzpage.com/api/v1/categories"

GET`/api/v1/meta`

Info dataset: data di importazione, numero oggetti, build di gioco

curl -H "Authorization: Bearer dzp_YOUR_KEY" "https://dzpage.com/api/v1/meta"

Errori, limiti e stabilità

Gli errori sono sempre JSON con codice stabile, messaggio leggibile e link alla documentazione:

{
  "error": "invalid_api_key",
  "message": "Invalid or revoked API key. …",
  "docs": "https://dzpage.com/api"
}

Stato · codice	Significato
401 · missing_api_key	Nessuna chiave API inviata. Aggiungi l'header «Authorization: Bearer» o «X-Api-Key».
401 · invalid_api_key	La chiave non esiste o è stata revocata.
404 · not_found	Nessun oggetto con questo nome classe o slug.
429 · rate_limited	Limite esaurito – attendi Retry-After secondi e riprova.
5xx	Errore del server – puoi riprovare senza rischi. Se persiste, segnalalo sul nostro Discord.

Ogni risposta riuscita include header di rate-limit così il tuo client può autoregolarsi:

X-RateLimit-Limit: 120
X-RateLimit-Remaining: 118
X-RateLimit-Reset: 1789000000
Retry-After: 31   (nur bei 429 / only on 429)

Regole del gioco

Un abbonamento copre i tuoi progetti, bot e strumenti server – fair use entro il limite.
Se lo usi nei tuoi progetti, un link a dzpage.com è gradito.
Le icone (URL icon / icon_thumb) restano liberamente linkabili – cache a lungo termine, nessuna chiave.
Questa API è v1: i campi possono essere aggiunti, quelli esistenti non saranno rimossi né rinominati.

Accesso e fair use

GET/api/v1/items

GET/api/v1/items/{class_name}

GET/api/v1/categories