Upravte chyby bez straty kontextu žiadosti.
{
"text": "Komplexný zdrojový obsah vo vybranom jazyku.",
"locale": "sk",
"mode": "simple-language"
}K dispozícii sú príklady SDK a cURL
Jednotné chybové správy
{
"error": {
"code": "invalid_request",
"message": "Check the request fields."
}
}Väčšina chýb používa vyššie uvedenú štruktúru error. Odpovede pri obmedzení rýchlosti obsahujú aj polia najvyššej úrovne limit, remaining a reset.
{
"error": {
"code": "rate_limited",
"message": "Too many requests."
},
"limit": 1000,
"remaining": 0,
"reset": 1787836800
}Pri obmedzení rýchlosti HTTP 429 počkajte podľa hlavičky Retry-After. allowance_exhausted namiesto toho obsahuje error.details.used, limit a periodEndsAt.
Chybové kódy
Tieto chybové kódy používajú verziu API 2:
| HTTP | Kód | Význam | Akcia klienta |
|---|---|---|---|
| 400 | invalid_json | Telo požiadavky nie je platný JSON | Opravte telo JSON |
| 400 | invalid_request | Pole chýba, je neznáme alebo neplatné alebo text presahuje 5 000 znakov | Popravte žiadosť |
| 400 | idempotency_key_required | Úloha alebo dávková požiadavka nemá platný kľúč idempotencie | Pošlite jedinečný kľúč s maximálne 255 znakmi |
| 400 | invalid_webhook_endpoint | Vybraný koncový bod webhooku chýba alebo je neaktívny | Vyberte aktívny koncový bod alebo použite hlasovanie |
| 401 | invalid_api_key | Token nosiča chýba, je neplatný alebo odvolaný | Skontrolujte alebo vymeňte kľúč API |
| 402 | billing_required | Pred pokračovaním spracovania je potrebné aktualizovať fakturáciu | Aktualizujte fakturáciu v aplikácii |
| 403 | požadované predplatné | Pracovný priestor nemá žiadne aktívne oprávnenie | Vyberte si plán alebo kontaktujte podporu |
| 403 | email_not_overified | Nie je overený žiadny e-mail vlastníka ani správcu | Overte vhodný e-mail účtu |
| 404 | job_not_found | Úloha neexistuje, patrí do iného pracovného priestoru alebo jej platnosť vypršala | Zastaviť dotaz stavu a spustiť novú objednávku v prípade potreby |
| 404 | batch_not_found | Dávka neexistuje, patrí do iného pracovného priestoru alebo jej platnosť vypršala | Zastavte prieskum a v prípade potreby vytvorte novú dávku |
| 429 | sadzba_obmedzená | Dosiahla sa miera žiadostí | Uctívajte sa po tom, čo ste sa pokúsili |
| 429 | Konmenná hranica | Súčasne sa spracováva príliš veľa žiadostí | Skúste to znova po dokončení aktívnej požiadavky |
| 429 | vyčerpaný príspevok | Dosiahli ste mesačný limit počtu znakov a ďalšie využitie nie je k dispozícii alebo je zakázané | Počkajte na ďalšie fakturačné obdobie alebo povoľte ďalšie používanie v rámci vhodného plánu |
| 502 | spracovanie_neúspešné | Službe sa nepodarilo spracovať text | Zopakujte žiadosť a podporu kontaktu s ID žiadosti, ak problém pretrváva |
Dokument pre každú chybu: Môže sa žiadosť zopakovať? Sú príznaky vypočítané? Čo je v zápisnici? Aké informácie potrebuje podpora?