Chyby
Neúspěšná odpověď má vždy tvar { ok: false, error: "slug" } (u invalid-input navíc pole detail s rozpisem, které pole selhalo). error je strojový slug - na něj se dá spolehnout ve vlastním kódu, text se nemění mezi verzemi.
| Status | error | Význam |
|---|---|---|
| 401 | invalid-key | Chybějící, neplatný nebo zneplatněný API klíč. |
| 403 | missing-scope | Klíč nemá scope, který endpoint vyžaduje (read/write). |
| 404 | not-found | Záznam s daným id neexistuje. |
| 409 | month-locked | Mutace míří do zamčeného měsíce (viz Koncepty -> Uzávěrka). |
| 409 | errors-present | Publikace týdne blokovaná chybovým varováním - zopakuj s confirm_errors: true, pokud vědomě přehlížíš. |
| 409 | already-decided | Žádost o volno už byla schválena/zamítnuta/zrušena. |
| 422 | invalid-input | Neplatný tvar/hodnoty vstupu - viz pole detail v odpovědi. |
| 429 | rate-limited | Přes 300 požadavků za minutu na klíč - viz hlavička Retry-After. |
Konkrétní endpointy mohou vracet i další slugy specifické pro danou operaci (např. employment-not-in-store u přiřazení směny, email-exists u založení zaměstnance) - viz API reference pro úplný seznam u každého endpointu.