REST API · v1

API itemů pro DayZ

Celá databáze itemů jako JSON – zdarma k použití s osobním API klíčem. Pro Discord boty, nástroje pro servery, overlaye a vlastní projekty.

Přístup a fair use

Všechny endpointy /api/v1 vyžadují bezplatný API klíč – brání zneužití a umožňuje férové rate limity. Předplatné není potřeba.

Přihlas se přes Discord – účet samotný je zdarma.
V nastavení si vytvoř bezplatný API klíč.
Vytvoř API klíč a posílej ho s každým požadavkem.

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

Nech si klíč pro sebe: volej API ze svého serveru, bota nebo backendu – kdo má klíč, čerpá tvůj limit. Klíč můžeš kdykoli v nastavení zrušit a vytvořit nový; ten starý okamžitě přestane fungovat.

Potřebuješ větší průchodnost? Volitelné předplatné podporovatele

Za 3,99 €/měsíc podpoříš průběžné náklady na server a tvůj rate limit vzroste z 60 na 300 požadavků za minutu. Zrušit můžeš každý měsíc v zákaznickém portálu.

Samotná herní data jsou a zůstanou volně přístupná všem – předplatné podporovatele platí výhradně kapacitu serveru (vyšší rate limit), nikdy ne data. DayZ a jeho herní data patří Bohemia Interactive a.s.

Spravovat předplatné a klíče

Vyžaduje se API klíč

Posílej klíč s každým požadavkem v hlavičce "Authorization: Bearer" nebo "X-Api-Key".

60 → 300 požadavků/min

Zdarma: 60 požadavků za minutu na klíč. S volitelným předplatným podporovatele: 300/min. Každá odpověď nese hlavičky X-RateLimit včetně X-RateLimit-Tier.

Skutečná herní data

Extrahovaná přímo z konfigurací DayZ, aktualizovaná po updatech hry.

GET`/api/v1/items`

Vyhledávání a filtrování itemů (stránkované)

Parametr	Popis
q	Hledání v názvu a class namu (fuzzy)
cat	Kategorie, např. Weapon, Food / Drink, Ammo
tier	Loot tier: Tier1 – Tier4 nebo Unique
sort	name (výchozí), damage, rpm nebo weight
page	Stránka, od 1
limit	Výsledků na stránku, 1–100 (výchozí 48)
icons	1 = jen itemy s ikonou
lang	Jazyk pole name: en, de, fr, es, it, ru, pl, cs, pt, zh (výchozí en)

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

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

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

Jeden item se všemi detaily

Přijímá class namy (bez ohledu na velikost písmen) nebo slugy. Vrací všechna pole: staty zbraní, munici, zásobníky, doplňky, loot data, budovy, kde item spawnuje, recepty, všechny přeložené názvy a kompletní surová data z konfigurace.

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

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

GET`/api/v1/categories`

Všechny kategorie s počtem itemů

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

GET`/api/v1/meta`

Info o datové sadě: datum importu, počet itemů, build hry

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

Chyby, limity a stabilita

Chyby jsou vždycky JSON se stabilním kódem chyby, srozumitelnou zprávou a odkazem do dokumentace:

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

Status · kód	Význam
401 · missing_api_key	Nebyl poslán žádný API klíč. Doplň hlavičku "Authorization: Bearer" nebo "X-Api-Key".
401 · invalid_api_key	Klíč neexistuje nebo byl zrušen.
404 · not_found	Žádný item s tímhle class namem nebo slugem.
429 · rate_limited	Rate limit je vyčerpaný – počkej počet sekund z Retry-After a zkus to znovu.
5xx	Chyba serveru – klidně to zkus znovu. Pokud to potrvá, nahlas to na našem Discordu.

Každá úspěšná odpověď obsahuje hlavičky s rate limitem, aby se tvůj klient uměl sám přibrzdit:

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

Základní pravidla

Jedno předplatné pokrývá tvoje vlastní projekty, boty a nástroje pro server – fair use v rámci rate limitu.
Když to použiješ ve vlastních projektech, potěší nás zpětný odkaz na dzpage.com.
Na ikony itemů (URL icon / icon_thumb) můžeš volně odkazovat přímo ze svého webu – jsou dlouhodobě cachované a klíč nepotřebují.
Tohle API je v1: pole mohou přibývat, stávající pole se nebudou odstraňovat ani přejmenovávat.

Přístup a fair use

GET/api/v1/items

GET/api/v1/items/{class_name}

GET/api/v1/categories