Chyby a limity

Všetky kódy a dôvody chýb API ako problémové dokumenty RFC 9457, limity požiadaviek na kľúč, odpovede pri preťažení, časové limity a opakovanie.

Problémové dokumenty

Chyby sú dokumenty RFC 9457 application/problem+json so stálym kódom code:

{
  "title": "Service Unavailable",
  "status": 503,
  "detail": "not found, but these sources are not fresh: rpo",
  "code": "unavailable",
  "reason": "source_stale"
}

`code`	Stav	Význam
`invalid_request`	400, 422	Parameter chýba alebo je mimo rozsahu; `errors` uvádza podrobnosti.
`invalid_identifier`	400	Id overenia nie je IČO, DIČ ani IČ DPH.
`fuzzy_disabled`	400	`mode=fuzzy` na inštancii, kde je vypnuté.
`unauthorized`	401	Chýba kľúč alebo je neznámy.
`forbidden`	403	Fyzická osoba podľa DIČ na inštancii s anonymným prístupom.
`not_found`	404	Nenájdené a všetky použité zdroje sú aktuálne.
`rate_limited`	429	Príliš veľa požiadaviek; pozrite `Retry-After`.
`unavailable`	503	Pozrite `reason`: `bootstrapping`, `setup` (prevádzkovateľ ešte nepotvrdil inštanciu), `source_stale`, `timeout`, `database` alebo `overloaded` (inštancia je na hranici výkonu: skúste znova po `Retry-After`).

503 berte ako „neznáme“: skúste to neskôr a nikdy to neberte ako „nenájdené“.

Limity požiadaviek

Každý klient (kľúč, alebo IP adresa v anonymnom režime) má vlastný limit typu token bucket, na každú inštanciu:

Limit	Predvolené	Premenná
Požiadavky	20 za sekundu, nárazovo 40	`REGISTER_RATE_PER_SECOND`, `REGISTER_RATE_BURST`
Približné vyhľadávania	1 za 5 s, nárazovo 2	`REGISTER_FUZZY_EVERY`
Súbežné približné vyhľadávania	1 na inštanciu	`REGISTER_FUZZY_CONCURRENCY`

Nad limitom je odpoveď 429 s Retry-After v sekundách. Nič sa nezaraďuje do fronty.

Časové limity

Dopyt	Predvolené	Premenná
Predvolené vyhľadávanie a overenie	3 s	`REGISTER_QUERY_TIMEOUT`
Približné vyhľadávanie	2 s	`REGISTER_FUZZY_TIMEOUT`

Dopyt nad časovým limitom vráti 503 s dôvodom timeout.