Valdyti klaidas, nesutinkant prašymo konteksto.
{
"text": "Sudėtingas šaltinio turinys pasirinkta kalba.",
"locale": "lt",
"mode": "simple-language"
}Galimi SDK ir cURL pavyzdžiai
Vienodi klaidų pranešimai
{
"error": {
"code": "invalid_request",
"message": "Check the request fields."
}
}Dauguma klaidų naudoja pirmiau pateiktą error struktūrą. Dažnio ribojimo atsakymuose aukščiausiu lygiu taip pat pateikiami laukai limit, remaining ir reset.
{
"error": {
"code": "rate_limited",
"message": "Too many requests."
},
"limit": 1000,
"remaining": 0,
"reset": 1787836800
}Gavę HTTP 429 dažnio apribojimą, palaukite pagal Retry-After antraštę. allowance_exhausted vietoje to pateikia error.details.used, limit ir periodEndsAt.
Gedimų kodai
Šie klaidų kodai naudoja API 2 versiją:
| HTTP | Kodas | Bet koks reikšmė | Kliento veiksmai |
|---|---|---|---|
| 400 | invalid_json | Užklausos turinys netinkamas JSON | Pataisykite JSON turinį |
| 400 | invalid_request | Trūksta lauko, jis nežinomas arba neteisingas, arba tekstas viršija 5 000 simbolių | Ištaisykite prašymą |
| 400 | idempotency_key_required | Darbo ar paketo užklausa neturi galiojančio Idempotency-Key | Siųskite unikalų raktą, kurį sudaro daugiausia 255 simboliai |
| 400 | invalid_webhook_endpoint | Trūksta pasirinkto „webhook“ galutinio taško arba jis neaktyvus | Pasirinkite aktyvų galinį tašką arba naudokite apklausą |
| 401 | invalid_api_key | Trūksta nešiklio prieigos rakto, jis negalioja arba atšauktas | Patikrinkite arba pakeiskite API raktą |
| 402 | billing_required | Kad būtų galima tęsti apdorojimą, atsiskaitymas turi būti atnaujintas | Atnaujinkite atsiskaitymą programoje |
| 403 | Būtina pasirašyti | Darbo sritis neturi aktyvių teisių | Pasirinkite planą arba susisiekite su palaikymo komanda |
| 403 | email_not_verified | Nepatvirtintas joks savininko ar administratoriaus el | Patvirtinkite tinkamos paskyros el. pašto adresą |
| 404 | darbas_nerastas | Darbo nėra, jis priklauso kitai darbo vietai arba pasibaigė | Sustabdyti būsenos užklausą ir, jei reikia, pradėti naują užsakymą |
| 404 | partijos_nerasta | Paketo nėra, ji priklauso kitai darbo sričiai arba pasibaigė jos galiojimo laikas | Sustabdykite apklausą ir, jei reikia, sukurkite naują partiją |
| 429 | norma_ribota | Užklausos rodiklis pasiektas | Pakelkite dėmesį į savo darbą |
| 429 | concurrence limit | Vienu metu apdorojama per daug užklausų | Baigę aktyvią užklausą, bandykite dar kartą |
| 429 | Išnaudotos išmokos | Pasiektas mėnesio simbolių limitas ir papildomas naudojimas nepasiekiamas arba išjungtas | Palaukite kito atsiskaitymo laikotarpio arba įgalinkite papildomą naudojimą pagal tinkamą planą |
| 502 | procesoris_neveiktas | Paslauga negalėjo apdoroti teksto | Pakartoti užklausą ir kontaktų palaikymą su užklausos ID, jei problema išlieka |
Kiekvienos klaidos dokumentas: ar galima pakartoti prašymą? Ar ženklai apskaičiuojami? Kas yra protokole? Kokia informacija reikalinga?