API referenca — Pregled

Za većinu slučajeva serverski SDK je lakši od direktnog pozivanja API-ja. Ali ako koristite jezik koji SDK ne podržava, ili jednostavno želite veću kontrolu — evo kako radi.

Bazni URL

https://www.kruzic.rs/api/v1

Autentifikacija

Authorization: Bearer kruzic_vaš_api_ključ

API ključ se generiše u kontrolnoj tabli pod SDK → Pregled → API ključ. Svaka igra ima zaseban ključ — igra se automatski identifikuje na osnovu njega.

Format odgovora

Svi odgovori dolaze u istom formatu:

// Uspeh
{ "success": true, "data": { ... } }

// Greška
{ "error": "Opis greške" }

Status	Značenje
`400`	Nedostaju parametri ili su neispravni
`401`	Token nedostaje ili je nevažeći
`429`	Previše zahteva — limit je 100/s po igri za data endpointe, 5/dan za obaveštenja

Endpointi

SDK endpointi — čitanje, pisanje i brisanje korisničkih podataka, slanje obaveštenja