REST API · v1

API przedmiotów DayZ

Cała baza przedmiotów w formacie JSON, do darmowego użytku z osobistym kluczem API. Do botów na Discorda, narzędzi serwerowych, nakładek i własnych projektów.

Korzystaj z DZPage w Claude, Codex i innych asystentach AISerwer MCP

DZPage udostępnia serwer MCP (Model Context Protocol). Podłącz go raz, a twój asystent AI będzie sam zaglądał na DZPage, kiedy ci pomaga: statystyki przedmiotów, loot, zarażeni, lista serwerów i aktualizacje gry. Może też sprawdzić pliki i logi twojego serwera. Nie potrzebujesz konta ani klucza API.

Adres serwera

https://dzpage.com/mcp

Claude (przeglądarka i aplikacja na komputer)

Otwórz ustawienia, przejdź do Connectors i dodaj własny konektor: jako nazwę wpisz DZPage, a jako URL powyższy adres serwera.

Claude Code

Uruchom to raz w terminalu:

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

Codex (CLI i rozszerzenie IDE)

Uruchom to raz albo dodaj blok do ~/.codex/config.toml:

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

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

Cursor i VS Code

Jedno kliknięcie otwiera aplikację na komputerze, która zapyta, zanim doda DZPage. Jeśli nic się nie dzieje, użyj konfiguracji poniżej.

Dodaj do Cursor Zainstaluj w VS Code

Inne klienty

Działa każdy klient, który obsługuje zdalne serwery MCP przez Streamable HTTP. W konfiguracji JSON wygląda to tak:

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

Co twój asystent może z tym zrobić

search_itemsSzukać w bazie przedmiotów po nazwie w dowolnym języku
get_itemWszystkie wartości przedmiotu: waga, rozmiar, statystyki broni, magazynki, akcesoria, tiery lootu i budynki, w których się pojawia
where_to_find_itemGdzie przedmiot pojawia się na mapie: miejsca z największą liczbą pasujących budynków, ze współrzędnymi i linkiem do mapy lootu
compare_weaponsPorównywać broń palną: obrażenia na dystansie i liczbę trafień do zabicia z kamizelką i bez
get_infectedZdrowie, strefy trafień, ataki i szanse na łup każdego zarażonego
search_serversZnajdować serwery społeczności na PC, PlayStation i Xbox z aktualną liczbą graczy
dayz_update_changesCo każda aktualizacja DayZ zmieniła w types.xml, events.xml i innych plikach vanilla
day_night_settingsPrzeliczać wybraną długość dnia i nocy na wartości do serverDZ.cfg
explain_server_settingWyjaśniać ustawienie z globals.xml lub cfggameplay.json: znaczenie, wartość vanilla, zakres i pasujący edytor
validate_config_fileZnajdować od razu wszystkie błędy składni w pliku serwera XML lub JSON
analyze_server_logWyjaśniać problemy w logu serwera i sposób ich naprawy
find_toolWskazywać właściwe narzędzie DZPage do zadania

Zapytaj na przykład

Ile trafień z AKM potrzeba na 200 m przeciw graczowi w kamizelce wzmacnianej?
Dlaczego mój serwer się wysypuje? Oto log RPT.
Co ostatnia aktualizacja DayZ zmieniła w types.xml na Czarnorusi?

Za darmo i tylko do odczytu, do 120 zapytań na minutę z jednego adresu IP, w tym do 6 sprawdzeń plików lub logów. Pliki i logi wysłane przez twojego asystenta są tylko sprawdzane, a nie zapisywane.

Dostęp i fair use

Wszystkie endpointy /api/v1 wymagają darmowego klucza API: chroni on przed nadużyciami i pozwala ustawić uczciwe limity zapytań. Klucz nic nie kosztuje.

Zaloguj się przez Discord. Samo konto jest darmowe.
Utwórz darmowy klucz API w ustawieniach.
Utwórz klucz API i wysyłaj go z każdym zapytaniem.

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

Trzymaj klucz w tajemnicy: wywołuj API ze swojego serwera, bota albo backendu. Kto ma klucz, ten zużywa twój limit. Klucz możesz w każdej chwili unieważnić w ustawieniach i utworzyć nowy; stary od razu przestaje działać.

Dane gry są i pozostają swobodnie dostępne dla wszystkich, a API jest darmowe i takie pozostanie. DayZ i jego dane gry należą do Bohemia Interactive a.s.

Zarządzaj kluczami API

Wymagany klucz API

Wysyłaj klucz w nagłówku "Authorization: Bearer" albo "X-Api-Key" przy każdym zapytaniu.

60 → 300 zapytań/min

60 zapytań na minutę na klucz. Każda odpowiedź zawiera nagłówki X-RateLimit.

Prawdziwe dane gry

Wyciągane prosto z configów DayZ, aktualizowane po patchach gry.

GET`/api/v1/items`

Wyszukiwanie i filtrowanie przedmiotów (ze stronicowaniem)

Parametr	Opis
q	Szukanie w nazwie i nazwie klasy (rozmyte)
cat	Kategoria, np. Weapon, Food / Drink, Ammo
tier	Tier lootu: od Tier1 do Tier4 albo Unique
sort	name (domyślnie), damage, rpm albo weight
page	Strona, od 1
limit	Wyników na stronę, od 1 do 100 (domyślnie 48)
icons	1 = tylko przedmioty z ikoną
lang	Język pola name: en, de, fr, es, it, ru, pl, cs, pt, zh (domyślnie en)

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

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

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

Pojedynczy przedmiot ze wszystkimi szczegółami

Przyjmuje nazwy klas (wielkość liter bez znaczenia) albo slugi. Zwraca wszystkie pola: statystyki broni, amunicję, magazynki, akcesoria, dane lootu, budynki ze spawnem, receptury, wszystkie przetłumaczone nazwy i kompletne surowe dane z configu.

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

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

GET`/api/v1/categories`

Wszystkie kategorie z liczbą przedmiotów

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

GET`/api/v1/meta`

Informacje o zbiorze danych: data importu, liczba przedmiotów, build gry

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

Błędy, limity i stabilność

Błędy zawsze przychodzą jako JSON ze stabilnym kodem błędu, zrozumiałym komunikatem i linkiem do dokumentacji:

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

Status · kod	Znaczenie
401 · missing_api_key	Nie wysłano klucza API. Dodaj nagłówek "Authorization: Bearer" albo "X-Api-Key".
401 · invalid_api_key	Klucz nie istnieje albo został unieważniony.
404 · not_found	Brak przedmiotu o tej nazwie klasy albo slugu.
429 · rate_limited	Limit zapytań wyczerpany. Odczekaj tyle sekund, ile podaje Retry-After, i spróbuj ponownie.
5xx	Błąd serwera. Spokojnie spróbuj ponownie. Jeśli się powtarza, zgłoś to na naszym Discordzie.

Każda udana odpowiedź zawiera nagłówki limitu zapytań, żeby twój klient mógł sam się przyhamować:

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

Podstawowe zasady

Jeden klucz obejmuje twoje własne projekty, boty i narzędzia serwerowe (fair use w ramach limitu zapytań).
Jeśli używasz tego we własnych projektach, ucieszy nas link do dzpage.com.
Ikony przedmiotów (adresy icon / icon_thumb) można swobodnie podlinkować: są cache'owane długoterminowo i nie wymagają klucza.
To API jest w wersji v1: mogą dochodzić nowe pola, ale istniejące nie zostaną usunięte ani przemianowane.

Ładowanie …

Przygotowujemy narzędzie

Korzystaj z DZPage w Claude, Codex i innych asystentach AISerwer MCP

Claude (przeglądarka i aplikacja na komputer)

Claude Code

Codex (CLI i rozszerzenie IDE)

Cursor i VS Code

Inne klienty

Co twój asystent może z tym zrobić

Zapytaj na przykład

Dostęp i fair use

GET/api/v1/items

GET/api/v1/items/{class_name}

GET/api/v1/categories

GET/api/v1/meta

Błędy, limity i stabilność

Podstawowe zasady

Korzystaj z DZPage w Claude, Codex i innych asystentach AISerwer MCP

Claude (przeglądarka i aplikacja na komputer)

Claude Code

Codex (CLI i rozszerzenie IDE)

Cursor i VS Code

Inne klienty

Co twój asystent może z tym zrobić

Zapytaj na przykład

Dostęp i fair use

GET/api/v1/items

GET/api/v1/items/{class_name}

GET/api/v1/categories

GET/api/v1/meta

Błędy, limity i stabilność

Podstawowe zasady

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`