Ograničenja
Brojevi ispod su oni koji trenutno važe na ovom sajtu.
| Šta se broji | Granica |
|---|---|
| Svi pozivi aplikacije u razvoju ili na pregledu | 120 u minuti |
| Svi pozivi javne aplikacije | 1.200 u minuti |
| Pozivi u ime jednog člana | 60 u minuti |
| Upisi u ime jednog člana (rezultati, aktivnost) | 10 u minuti |
| Zahtjevi za token (kod, obnova) | 30 u minuti |
Uz to: najviše 5 aplikacija po developeru, 25 testera i 5 rang listi po aplikaciji.
Zaglavlja
Svaki odgovor nosi X-RateLimit-Limit i X-RateLimit-Remaining. Kad pređeš granicu, dobiješ 429 i zaglavlje Retry-After sa brojem sekundi:
{
"error": "rate_limited",
"message": "Previše zahtjeva. Pokušaj ponovo za 21 s.",
"retry_after": 21
}
Sačekaj retry_after sekundi prije sljedećeg poziva. Nemoj odmah ponavljati.
Automatska suspenzija
Aplikacija koja stalno prelazi svoju granicu suspenduje se sama i ti dobiješ obavijest sa obrazloženjem. Suspendovanoj aplikaciji nijedan token ne važi. Kad ispraviš uzrok, javi se administraciji da ukine suspenziju.
Oblik greške
Sve greške javnog API-ja imaju isti oblik:
{ "error": "kod_greske", "message": "Tekst za developera" }
U kodu poredi polje error. Tekst u message se može promijeniti.
| HTTP | error |
Značenje |
|---|---|---|
| 401 | invalid_token |
token nedostaje, istekao je ili je pristup ukinut |
| 403 | insufficient_scope |
token nema dozvolu za ovaj poziv (naziv je u polju scope) |
| 403 | forbidden |
radnja nije dozvoljena |
| 404 | not_found |
nema toga, ili ga prijavljeni član ne smije vidjeti |
| 422 | validation_failed |
neispravni podaci, greške po polju su u errors |
| 429 | rate_limited |
previše zahtjeva, vidi retry_after |
| 500 | server_error |
greška kod nas, pokušaj kasnije |
Primjer greške validacije:
{
"error": "validation_failed",
"message": "Polje score mora biti cijeli broj.",
"errors": { "score": ["Polje score mora biti cijeli broj."] }
}
Oblik odgovora
- Uspješan odgovor nosi podatke u polju
data. - Datumi su ISO 8601 sa vremenskom zonom, npr.
2026-11-15T19:42:07+00:00. - Polje koje član ne prikazuje na profilu ima vrijednost
null. - Nova polja mogu biti dodana bez najave. Postojeća polja ne mijenjamo i ne uklanjamo bez nove verzije API-ja.