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.

Usa DZPage in Claude, Codex e altri assistenti IAServer MCP

DZPage offre un server MCP (Model Context Protocol). Collegalo una volta e il tuo assistente IA consulterà DZPage da solo mentre ti aiuta: statistiche degli oggetti, loot, infetti, la lista dei server e gli aggiornamenti del gioco. Può anche controllare i file e i log del tuo server. Non servono né un account né una chiave API.

Indirizzo del server

https://dzpage.com/mcp

Claude (web e app desktop)

Apri le impostazioni, vai su Connectors e aggiungi un connettore personalizzato: DZPage come nome e l'indirizzo del server qui sopra come URL.

Claude Code

Esegui questo comando una volta nel terminale:

claude mcp add --transport http dzpage https://dzpage.com/mcp

Codex (CLI ed estensione IDE)

Esegui questo comando una volta oppure aggiungi il blocco a ~/.codex/config.toml:

codex mcp add dzpage --url https://dzpage.com/mcp

# ~/.codex/config.toml
[mcp_servers.dzpage]
url = "https://dzpage.com/mcp"

Cursor e VS Code

Un clic apre l'app sul tuo computer, che chiede conferma prima di aggiungere DZPage. Se non succede nulla, usa la configurazione qui sotto.

Aggiungi a Cursor Installa in VS Code

Altri client

Funziona con qualsiasi client che supporti server MCP remoti tramite Streamable HTTP. In una configurazione JSON appare così:

{
  "mcpServers": {
    "dzpage": {
      "type": "http",
      "url": "https://dzpage.com/mcp"
    }
  }
}

Cosa può farci il tuo assistente

search_itemsCercare nel database degli oggetti per nome in qualsiasi lingua
get_itemTutti i valori di un oggetto: peso, dimensioni, statistiche dell'arma, caricatori, accessori, tier di loot ed edifici di spawn
where_to_find_itemDove compare un oggetto su una mappa: i luoghi con più edifici adatti, con coordinate e link alla mappa loot
compare_weaponsConfrontare armi da fuoco: danno a distanza e colpi per uccidere con e senza giubbotto
get_infectedSalute, zone di impatto, attacchi e probabilità di drop di ogni infetto
search_serversTrovare server della community per PC, PlayStation e Xbox con il numero di giocatori in tempo reale
dayz_update_changesCosa ha cambiato ogni aggiornamento di DayZ in types.xml, events.xml e negli altri file vanilla
day_night_settingsConvertire la durata del giorno e della notte che vuoi nei valori per serverDZ.cfg
explain_server_settingSpiegare un'impostazione di globals.xml o cfggameplay.json: significato, valore vanilla, intervallo ed editor adatto
validate_config_fileTrovare in una volta tutti gli errori di sintassi di un file del server XML o JSON
analyze_server_logSpiegare i problemi in un log del server e come risolverli
find_toolIndicarti lo strumento DZPage giusto per un compito

Chiedi per esempio

Quanti colpi servono a un AKM a 200 m contro un giocatore con giubbotto con piastre?
Perché il mio server va in crash? Ecco il log RPT.
Cosa ha cambiato l'ultimo aggiornamento di DayZ in types.xml su Chernarus?

Gratuito e in sola lettura, fino a 120 richieste al minuto per indirizzo IP, di cui al massimo 6 controlli di file o log. I file e i log inviati dal tuo assistente vengono solo controllati, non salvati.

Accesso e fair use

Tutti gli endpoint /api/v1 richiedono una chiave API gratuita: tiene fuori gli abusi e rende possibili limiti equi. La chiave non costa nulla.

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.

I dati di gioco restano liberamente accessibili a tutti: l'API è gratuita e lo resterà. DayZ e i suoi dati appartengono a Bohemia Interactive a.s.

Gestisci le chiavi API

Chiave API obbligatoria

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

60 → 300 richieste/min

60 richieste al minuto per chiave. Ogni risposta porta header X-RateLimit.

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: da Tier1 a Tier4 o Unique
sort	name (predefinito), damage, rpm o weight
page	Pagina, da 1
limit	Risultati per pagina, da 1 a 100 (predefinito 48)
icons	1 = solo oggetti con icona
lang	Lingua del campo name: en, de, fr, es, it, ru, pl, cs, pt, zh (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

Una chiave 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.

Caricamento …

Preparazione dello strumento

Usa DZPage in Claude, Codex e altri assistenti IAServer MCP

Claude (web e app desktop)

Claude Code

Codex (CLI ed estensione IDE)

Cursor e VS Code

Altri client

Cosa può farci il tuo assistente

Chiedi per esempio

Accesso e fair use

GET/api/v1/items

GET/api/v1/items/{class_name}

GET/api/v1/categories

GET/api/v1/meta

Errori, limiti e stabilità

Regole del gioco

Usa DZPage in Claude, Codex e altri assistenti IAServer MCP

Claude (web e app desktop)

Claude Code

Codex (CLI ed estensione IDE)

Cursor e VS Code

Altri client

Cosa può farci il tuo assistente

Chiedi per esempio

Accesso e fair use

GET/api/v1/items

GET/api/v1/items/{class_name}

GET/api/v1/categories

GET/api/v1/meta

Errori, limiti e stabilità

Regole del gioco

GET`/api/v1/items`

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

GET`/api/v1/categories`

GET`/api/v1/meta`

GET`/api/v1/items`

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

GET`/api/v1/categories`

GET`/api/v1/meta`