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
Enotna sporočila o napakah
{
"error": {
"code": "invalid_request",
"message": "Check the request fields."
}
}Večina napak uporablja zgornjo strukturo error. Odgovori ob omejitvi hitrosti vsebujejo tudi polja najvišje ravni limit, remaining in reset.
{
"error": {
"code": "rate_limited",
"message": "Too many requests."
},
"limit": 1000,
"remaining": 0,
"reset": 1787836800
}Pri omejitvah hitrosti HTTP 429 počakaj skladno z glavo Retry-After. allowance_exhausted namesto tega vsebuje error.details.used, limit in periodEndsAt.
Kode napak
Te kode napak uporabljajo API različico 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 5.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 | zahtevana naročnina | 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 | Ustavi poizvedbo stanja in po potrebi zažene novo naročilo |
| 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 | Meja sočasne poravnave | Obdeluje se preveč zahtev hkrati | Poskusite znova, ko se aktivna zahteva konča |
| 429 | Izčrpen dodatek | 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 | Ponovite zahtevo in kontaktno podporo z ID zahteve, če težava še vedno obstaja |
Dokument za vsako napako: Ali se lahko zahteva ponovi? Ali so znaki izračunani? Kaj je v zapisniku? Katere informacije potrebuje podpora?