Řešení chyb bez ztráty souvislosti žádosti.
{
"text": "Komplexní zdrojový obsah ve zvoleném jazyce.",
"locale": "cs",
"mode": "simple-language"
}Dostupné příklady SDK a cURL
Jednotná chybová hlášení
{
"error": {
"code": "invalid_request",
"message": "Check the request fields."
}
}Většina chyb používá výše uvedenou error obálku. Odpovědi při omezení rychlosti navíc obsahují pole limit, remaining a reset na nejvyšší úrovni.
{
"error": {
"code": "rate_limited",
"message": "Too many requests."
},
"limit": 1000,
"remaining": 0,
"reset": 1787836800
}Při omezení rychlosti HTTP 429 vyčkejte podle hlavičky Retry-After. allowance_exhausted místo toho obsahuje error.details.used, limit a periodEndsAt.
Vypouštění
Tyto chybové kódy používají verze API 2:
| HTTP | Kód | Význam | Akce klienta |
|---|---|---|---|
| 400 | invalid_json | Tělo požadavku není platný JSON | Opravte tělo JSON |
| 400 | invalid_request | Pole chybí, je neznámé nebo neplatné nebo text přesahuje 5 000 znaků | Opravte žádost |
| 400 | idempotency_key_required | Úloha nebo dávkový požadavek nemá platný klíč idempotence | Pošlete jedinečný klíč o délce maximálně 255 znaků |
| 400 | invalid_webhook_endpoint | Vybraný koncový bod webhooku chybí nebo je neaktivní | Vyberte aktivní koncový bod nebo použijte dotazování |
| 401 | invalid_api_key | Token nositele chybí, je neplatný nebo odvolán | Zkontrolujte nebo vyměňte klíč API |
| 402 | billing_required | Před pokračováním ve zpracování je nutné aktualizovat fakturaci | Aktualizujte fakturaci v aplikaci |
| 403 | feature_not_available | Pracovní plocha nemá žádné aktivní oprávnění | Vyberte plán nebo kontaktujte podporu |
| 403 | email_not_verified | Není ověřen žádný e-mail vlastníka ani správce | Ověřte způsobilý e-mail účtu |
| 404 | job_not_found | Úloha neexistuje, patří do jiného pracovního prostoru nebo vypršela její platnost | Zastavte dotaz na stav a v případě potřeby spusťte novou objednávku |
| 404 | batch_not_found | Dávka neexistuje, patří do jiného pracovního prostoru nebo vypršela platnost | Zastavte dotazování a v případě potřeby vytvořte novou dávku |
| 429 | rate_limited | Míra požadavků byla dosažena | Pozor po zkoušce |
| 429 | concurrency_limit | Současně se zpracovává příliš mnoho požadavků | Zkuste to znovu po dokončení aktivního požadavku |
| 429 | allowance_exhausted | Bylo dosaženo měsíčního limitu počtu znaků a další využití není k dispozici nebo je zakázáno | Počkejte na další fakturační období nebo povolte další využití na způsobilém plánu |
| 502 | processing_failed | Služba nemohla zpracovat text | Opakujte požadavek, a pokud problém přetrvává, kontaktujte podporu |
Za každou chybu zdokumentujte: je možné opakovat žádost? Jsou počítány znaky? Co je v protokolu? Jaké údaje potřebuje podpora?