Upravljajte pogreškama bez gubitka konteksta zahtjeva.
{
"text": "Složen izvorni sadržaj na odabranom jeziku.",
"locale": "hr",
"mode": "simple-language"
}Dostupni primjeri SDK-a i cURL-a
Jedinstvene poruke o pogreškama
{
"error": {
"code": "invalid_request",
"message": "Check the request fields."
}
}Većina pogrešaka koristi gornju strukturu error. Odgovori za ograničenje brzine sadrže i polja najviše razine limit, remaining i reset.
{
"error": {
"code": "rate_limited",
"message": "Too many requests."
},
"limit": 1000,
"remaining": 0,
"reset": 1787836800
}Za ograničenja brzine HTTP 429 pričekajte prema zaglavlju Retry-After. allowance_exhausted umjesto toga sadrži error.details.used, limit i periodEndsAt.
Kode pogrešaka
Ovaj greška kod koristi API verziju 2:
| HTTP | Kod | Značenje | Klijentova akcija |
|---|---|---|---|
| 400 | invalid_json | Tijelo zahtjeva nije važeći JSON | Ispravite JSON tijelo |
| 400 | invalid_request | Polje nedostaje, nepoznato je ili nije valjano ili tekst premašuje 5.000 znakova | Popravite zahtjev |
| 400 | nevažeći_ključ_idempotencije | Zahtjev za posao ili paket nema važeći ključ idempotencije | Pošaljite jedinstveni ključ od najviše 255 znakova |
| 400 | invalid_webhook_endpoint | Odabrana završna točka web-dojavnika nedostaje ili je neaktivna | Odaberite aktivnu krajnju točku ili upotrijebite prozivanje |
| 401 | nevažeći_api_ključ | Token nositelja nedostaje, nije valjan ili je opozvan | Provjerite ili zamijenite API ključ |
| 402 | billing_required | Naplata se mora ažurirati prije nastavka obrade | Ažurirajte naplatu u aplikaciji |
| 403 | feature_not_available | Radni prostor nema aktivna ovlaštenja | Odaberite plan ili kontaktirajte podršku |
| 403 | email_not_verified | E-pošta vlasnika ili administratora nije potvrđena | Potvrdite e-poštu računa koja ispunjava uvjete |
| 404 | posao_nije_nađen | Posao ne postoji, pripada drugom radnom prostoru ili je istekao | Zaustavite upit statusa i po potrebi pokrenite novi nalog |
| 404 | serija_nije_pronađena | Serija ne postoji, pripada drugom radnom prostoru ili je istekla | Zaustavite anketiranje i stvorite novu skupinu ako je potrebno |
| 429 | stopa_ograničena | Stopa zahtjeva je dosegnuta | Poštovanje nakon pokušaja |
| 429 | concurrency_limit | Previše zahtjeva se obrađuje u isto vrijeme | Pokušajte ponovno nakon završetka aktivnog zahtjeva |
| 429 | allowance_exhausted | Dosegnuto je mjesečno ograničenje broja znakova i dodatna upotreba nije dostupna ili je onemogućena | Pričekajte sljedeće obračunsko razdoblje ili omogućite dodatnu upotrebu na prihvatljivom planu |
| 502 | proces_neuspišan | Usluga nije mogla obraditi tekst | Ponovi zahtjev i kontaktirajte podršku s ID zahtjeva ako problem nastavi |
Dokumentacija za svaku pogrešku: može li se upita ponoviti? Su li znakovi izračunati? Što piše u protokolu? Kakve informacije potporu treba?