Skip to main content
DAYZERO Portál vystavuje REST API verze v1. Frontend ho používá interně, externí integrace stejné endpointy.

​
Base URL

https://dayzero.cz/portal/api/v1
V testovacím prostředí (developer mode) je root URL nastavený v app.json (app.rooturl).

​
Verzování

API je verzované cestou (/api/v1/...). Future verze by měla být /api/v2/.... Aktuálně existuje pouze v1.

​
Content Type

Vždy JSON:
  • Request: Content-Type: application/json (kromě uploadů, které jsou multipart/form-data).
  • Response: Content-Type: application/json; charset=utf-8.

​
Autentizace

Session-based, přes cookie. Detail v Autentizace.

​
Formát odpovědi

Standardizovaný envelope: 
{
  "status": "ok",
  "data": { ... },
  "message": null
}
Detail v Formát odpovědi.

​
Chybové kódy

HTTP statusy + JSON s polem status: "error". Detail v Chybové kódy.

​
Rate limiting

Default 30 požadavků za 60 sekund per IP per endpoint. Přesnější mechanika v Rate limiting.

​
Reference

Po levé straně najdete kompletní seznam endpointů rozdělený do skupin:

Auth

Login, register, 2FA, recovery, OAuth.

Users

Profil, search, layout, devices, anthem.

Characters

CRUD a kill/publish.

Factions

Frakce, členové, role.

Admin

Admin endpointy (users, whitelists, webhooks).

Achievements

Achievement správa a uživatelské.

​
Spadá pod „experimentální”?

Některé endpointy mají v API.md pomocnou poznámku — v komentáři / popisu. Pokud ho voláte z externí integrace, raději si ověřte, jestli endpoint není experimentální (může se měnit bez upozornění).