API v2 Reference

Quickstart

Hol dir einen Key, dann schick deinen ersten Request.

1. Mit Discord auf /user/api-keys.php einloggen.
2. „Neuen API-Key erstellen" → Label angeben → Key sicher kopieren (wird nur einmal angezeigt).
3. Request senden:

curl -H "Authorization: Bearer dzt_xxxxxxxx_yyyy…" \
  https://www.dayztools.de/api/v2/items/M4A1?lang=en

Authentication

Bearer-Token im Authorization-Header. Alternativ ?key=… als Query-Parameter (für Embeds; weniger sicher, da der Key in URLs/Logs erscheint).

Authorization: Bearer dzt_a3f9c12b_4d2e6f8a1b9c3d5e7f0a2b4c6d8e0f12

Format: dzt_ + 8 Hex-Zeichen Prefix + _ + 32 Hex-Zeichen Secret. Ein ungültiger oder revokter Key gibt 403 Forbidden, ein fehlender Key 401 Unauthorized.

Rate Limits

Jeder Response enthält Rate-Limit-Header. Bei Überschreitung kommt 429 Too Many Requests mit Retry-After.

Header bei jedem Call:

Reset täglich um 00:00 UTC. Tageszähler abrufen via GET /me.

Response Format

Alle Responses sind JSON mit einem konsistenten Envelope:

{
  "ok":   true,
  "data": // Resource oder Array,
  "meta": { // optional, bei Listen
    "total":  4832,
    "limit":  50,
    "offset": 0,
    "lang":   "en"
  }
}

Bei Fehlern:

{
  "ok":      false,
  "error":   "rate_limit",
  "message": "Rate limit exceeded.",
  "retry_after": 42
}

Errors

Pagination & Filter

Listen-Endpoints (/items, /loot) unterstützen limit und offset. Filter werden als zusätzliche Query-Parameter angehängt und mit AND kombiniert.

GET /api/v2/items?category=Weapon&tier=Tier4&map=chernarus&limit=20&offset=40

Die meta-Properties total / limit / offset verraten dir die Gesamtanzahl. Mit offset = (page - 1) * limit blätterst du durch.

Languages

Item-display_name und description sind in 13 Sprachen verfügbar. Wähle mit ?lang=<code>. Default: Englisch.

curl -H "Authorization: Bearer $KEY" \
  "https://www.dayztools.de/api/v2/items/BearTrap?lang=de"
// → "display_name": "Bärenfalle"

Endpoints

Base-URL: https://www.dayztools.de/api/v2

Code-Beispiele

KEY="dzt_xxxxxxxx_yyyy…"

# Detail eines Items
curl -H "Authorization: Bearer $KEY" \
  "https://www.dayztools.de/api/v2/items/M4A1?lang=de"

# Liste mit Filtern
curl -H "Authorization: Bearer $KEY" \
  "https://www.dayztools.de/api/v2/items?category=Weapon&tier=Tier3&limit=20"

# Eigener Key-Status
curl -H "Authorization: Bearer $KEY" \
  https://www.dayztools.de/api/v2/me

const KEY = 'dzt_xxxxxxxx_yyyy…';

async function getItem(name, lang = 'en') {
  const res = await fetch(
    `https://www.dayztools.de/api/v2/items/${name}?lang=${lang}`,
    { headers: { Authorization: `Bearer ${KEY}` } }
  );
  const { data } = await res.json();
  return data;
}

const m4 = await getItem('M4A1', 'de');
console.log(m4.display_name, m4.compat_magazines);

import requests

KEY = "dzt_xxxxxxxx_yyyy…"
BASE = "https://www.dayztools.de/api/v2"

def search(category, tier=None, lang="en"):
    r = requests.get(
        f"{BASE}/items",
        params={"category": category, "tier": tier, "lang": lang, "limit": 50},
        headers={"Authorization": f"Bearer {KEY}"},
        timeout=10,
    )
    r.raise_for_status()
    return r.json()["data"]

weapons = search("Weapon", tier="Tier4", lang="de")
for w in weapons:
    print(w["class_name"], "—", w["display_name"])

<?php
$key = 'dzt_xxxxxxxx_yyyy…';
$ctx = stream_context_create(['http' => [
    'header' => "Authorization: Bearer $key",
]]);
$json = file_get_contents(
    'https://www.dayztools.de/api/v2/items/M4A1?lang=de', false, $ctx
);
$data = json_decode($json, true)['data'];
echo $data['display_name'], "\n";