Upravljajte napake, ne da bi izgubili kontekst zahteve.
{
"text": "Kompleksna izvorna vsebina v izbranem jeziku.",
"locale": "sl",
"mode": "simple-language"
}Na voljo so primeri SDK in cURL
Napaka za napako
Ovojnica produkcijske napake različice 2 vsebuje objekt napake s stabilno kodo in sporočilnimi polji.
{
"error": {
"code": "invalid_request",
"message": "Check the request fields."
}
}Izbirni predmet podrobnosti nosi strojno berljiv kontekst, kot je retryAfterSeconds.
Glave odzivov HTTP vsebujejo metapodatke za preverjanje pristnosti in ponovni poskus, kjer je to primerno.
Katalog zahtevanih napak
Naslednje kode so trenutna pogodba različice 2.
| HTTP | Šifra | Pomembno | Dejanje stranke |
|---|---|---|---|
| 400 | invalid_json | Telo zahteve ni veljaven JSON | Popravite telo JSON |
| 400 | invalid_request | Polje manjka, je neznano ali neveljavno ali besedilo presega 10.000 znakov | Popravite zahtevo |
| 400 | neveljaven_ključ_idempotence | Zahteva za opravilo ali paket nima veljavnega ključa idempotence | Pošljite edinstven ključ z največ 255 znaki |
| 400 | neveljavna_končna_točka_webhook | Izbrana končna točka webhook manjka ali je neaktivna | Izberite aktivno končno točko ali uporabite anketiranje |
| 401 | neveljaven_api_ključ | Žeton nosilca manjka, je neveljaven ali preklican | Preverite ali zamenjajte ključ API |
| 402 | billing_required | Pred nadaljevanjem obdelave je treba posodobiti obračun | Posodobite obračunavanje v aplikaciji |
| 403 | naročnina_potrebna | Delovni prostor nima aktivnih pravic | Izberite načrt ali se obrnite na podporo |
| 403 | email_not_verified | E-poštni naslov lastnika ali skrbnika ni preverjen | Preverite ustrezen e-poštni naslov računa |
| 404 | job_not_found | Opravilo ne obstaja, pripada drugemu delovnemu prostoru ali je poteklo | Ustavite glasovanje in po potrebi ustvarite novo delovno mesto |
| 404 | batch_not_found | Paket ne obstaja, pripada drugemu delovnemu prostoru ali pa je potekel | Ustavite glasovanje in po potrebi ustvarite novo skupino |
| 429 | rate_limited | Stopnja zahtev je bila dosežena | Spoštovanje po ponovnem poskusu |
| 429 | omejitev_sočasnosti | Obdeluje se preveč zahtev hkrati | Poskusite znova, ko se aktivna zahteva konča |
| 429 | nadomestilo_izčrpano | Mesečna omejitev znakov je dosežena in dodatna uporaba ni na voljo ali onemogočena | Počakajte na naslednje obračunsko obdobje ali omogočite dodatno uporabo na ustreznem paketu |
| 502 | obdelava_ni uspela | Storitev ni mogla obdelati besedila | Varno poskusite znova in se obrnite na podporo z ID-jem zahteve, če se nadaljuje |
Za vsako napako, možnost ponovnega poskusa dokumenta, učinek obračunavanja, vidnost dnevnika in informacije o podpori.