REST-API · v1

DayZ Item-API

Die komplette Item-Datenbank als JSON – frei nutzbar mit persönlichem API-Key. Für Discord-Bots, Server-Tools, Overlays und eigene Projekte.

Zugang & Fair Use

Alle /api/v1-Endpunkte brauchen einen kostenlosen API-Key – er hält Missbrauch draußen und macht faire Rate-Limits möglich. Der Key kostet nichts.

Mit Discord einloggen – das Konto selbst ist kostenlos.
Erstelle in den Einstellungen einen kostenlosen API-Key.
API-Key erstellen und bei jeder Anfrage mitsenden.

# 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"

Halte deinen Key geheim: Ruf die API von deinem Server, Bot oder Backend auf – wer den Key hat, verbraucht dein Kontingent. Du kannst einen Key jederzeit in den Einstellungen widerrufen und einen neuen erstellen; der alte funktioniert sofort nicht mehr.

Die Spieldaten sind und bleiben für alle frei zugänglich – die API ist kostenlos und bleibt es. DayZ und seine Spieldaten gehören Bohemia Interactive a.s.

API-Keys verwalten

API-Key erforderlich

Sende den Key als „Authorization: Bearer“- oder „X-Api-Key“-Header bei jeder Anfrage.

60 → 300 Requests/min

60 Anfragen pro Minute je Key. Jede Antwort trägt X-RateLimit-Header.

Echte Spieldaten

Direkt aus den DayZ-Configs extrahiert, aktualisiert nach Updates.

GET`/api/v1/items`

Items durchsuchen und filtern (paginiert)

Parameter	Beschreibung
q	Suche in Name und Klassenname (fuzzy)
cat	Kategorie, z. B. Weapon, Food / Drink, Ammo
tier	Loot-Tier: Tier1 – Tier4 oder Unique
sort	name (Standard), damage, rpm oder weight
page	Seite, ab 1
limit	Treffer pro Seite, 1–100 (Standard 48)
icons	1 = nur Items mit Icon
lang	Sprache des name-Felds: en, de, fr, es, it, ru, pl, cs, pt, zh (Standard en)

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

{
  "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/de/items/akm"
    }
  ]
}

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

Einzelnes Item mit allen Details

Akzeptiert Klassennamen (Groß-/Kleinschreibung egal) oder Slug. Liefert alle Felder: Waffen-Stats, Munition, Magazine, Aufsätze, Loot-Daten, Spawn-Gebäude, Rezepte, alle übersetzten Namen und die kompletten Rohdaten aus der Spiel-Config.

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

// 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.de, item.weapon_stats.rpm_full_auto);

GET`/api/v1/categories`

Alle Kategorien mit Item-Anzahl

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

GET`/api/v1/meta`

Datenstand: Import-Datum, Item-Anzahl, Spiel-Build

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

Fehler, Limits & Stabilität

Fehler sind immer JSON mit stabilem Fehlercode, verständlicher Meldung und Doku-Link:

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

Status · Code	Bedeutung
401 · missing_api_key	Kein API-Key gesendet. Ergänze den „Authorization: Bearer“- oder „X-Api-Key“-Header.
401 · invalid_api_key	Der Key existiert nicht oder wurde widerrufen.
404 · not_found	Kein Item mit diesem Klassennamen oder Slug.
429 · rate_limited	Rate-Limit ausgeschöpft – warte Retry-After Sekunden und versuch es erneut.
5xx	Serverfehler – einfach erneut versuchen. Falls dauerhaft: melde es auf unserem Discord.

Jede erfolgreiche Antwort enthält Rate-Limit-Header, damit sich dein Client selbst drosseln kann:

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

Spielregeln

Ein Key deckt eigene Projekte, Bots und Server-Tools ab – Fair Use innerhalb des Rate-Limits.
Bei Nutzung in eigenen Projekten freuen wir uns über einen Link auf dzpage.com.
Item-Icons (icon-/icon_thumb-URLs) bleiben frei verlinkbar – sie sind langzeit-gecacht und brauchen keinen Key.
Die API ist v1: Felder kommen ggf. dazu, bestehende Felder werden nicht entfernt oder umbenannt.

Lädt …

Das Werkzeug wird vorbereitet

Zugang & Fair Use

Alle /api/v1-Endpunkte brauchen einen kostenlosen API-Key – er hält Missbrauch draußen und macht faire Rate-Limits möglich. Der Key kostet nichts.

Mit Discord einloggen – das Konto selbst ist kostenlos.

Erstelle in den Einstellungen einen kostenlosen API-Key.

API-Key erstellen und bei jeder Anfrage mitsenden.

# 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"

Die Spieldaten sind und bleiben für alle frei zugänglich – die API ist kostenlos und bleibt es. DayZ und seine Spieldaten gehören Bohemia Interactive a.s.

API-Keys verwalten

Parameter

Beschreibung

Suche in Name und Klassenname (fuzzy)

cat

Kategorie, z. B. Weapon, Food / Drink, Ammo

tier

Loot-Tier: Tier1 – Tier4 oder Unique

sort

name (Standard), damage, rpm oder weight

page

Seite, ab 1

limit

Treffer pro Seite, 1–100 (Standard 48)

icons

1 = nur Items mit Icon

lang

Sprache des name-Felds: en, de, fr, es, it, ru, pl, cs, pt, zh (Standard en)

{ "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/de/items/akm" } ] }

// 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.de, item.weapon_stats.rpm_full_auto);

Fehler, Limits & Stabilität

Fehler sind immer JSON mit stabilem Fehlercode, verständlicher Meldung und Doku-Link:

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

Status · Code	Bedeutung
401 · missing_api_key	Kein API-Key gesendet. Ergänze den „Authorization: Bearer“- oder „X-Api-Key“-Header.
401 · invalid_api_key	Der Key existiert nicht oder wurde widerrufen.
404 · not_found	Kein Item mit diesem Klassennamen oder Slug.
429 · rate_limited	Rate-Limit ausgeschöpft – warte Retry-After Sekunden und versuch es erneut.
5xx	Serverfehler – einfach erneut versuchen. Falls dauerhaft: melde es auf unserem Discord.

Jede erfolgreiche Antwort enthält Rate-Limit-Header, damit sich dein Client selbst drosseln kann:

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

Spielregeln

Ein Key deckt eigene Projekte, Bots und Server-Tools ab – Fair Use innerhalb des Rate-Limits.

Bei Nutzung in eigenen Projekten freuen wir uns über einen Link auf dzpage.com.

Item-Icons (icon-/icon_thumb-URLs) bleiben frei verlinkbar – sie sind langzeit-gecacht und brauchen keinen Key.

Die API ist v1: Felder kommen ggf. dazu, bestehende Felder werden nicht entfernt oder umbenannt.

Zugang & Fair Use

GET/api/v1/items

GET/api/v1/items/{class_name}

GET/api/v1/categories

GET/api/v1/meta

Fehler, Limits & Stabilität

Spielregeln

Zugang & Fair Use

GET/api/v1/items

GET/api/v1/items/{class_name}

GET/api/v1/categories

GET/api/v1/meta

Fehler, Limits & Stabilität

Spielregeln

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`