A hibák kezelése anélkül, hogy elveszítené a kérés kontextusát.
{
"text": "Összetett forrástartalom a kiválasztott nyelven.",
"locale": "hu",
"mode": "simple-language"
}SDK- és cURL-példák állnak rendelkezésre
Egységes hibaüzenetek
{
"error": {
"code": "invalid_request",
"message": "Check the request fields."
}
}A legtöbb hiba a fenti error-struktúrát használja. A sebességkorlátozási válaszok felső szinten a limit, remaining és reset mezőket is tartalmazzák.
{
"error": {
"code": "rate_limited",
"message": "Too many requests."
},
"limit": 1000,
"remaining": 0,
"reset": 1787836800
}HTTP 429 sebességkorlátozásnál várjon a Retry-After fejléc szerint. Az allowance_exhausted ehelyett az error.details.used, limit és periodEndsAt mezőket tartalmazza.
Hibás kódok
Ezek a hibakódok a API 2-es verziót használják:
| HTTP | Kód | A jelentés | Ügyfélkedvezés |
|---|---|---|---|
| 400 | érvénytelen_json | A kérelem törzse nem érvényes JSON | Javítsa ki a JSON törzset |
| 400 | invalid_request | Egy mező hiányzik, ismeretlen vagy érvénytelen, vagy a szöveg meghaladja a 5 000 karaktert | Javítsák a kérést |
| 400 | érvénytelen_idempotenciakulcs | Egy feladatnak vagy kötegelt kérésnek nincs érvényes identitáskulcsa | Legfeljebb 255 karakterből álló egyedi kulcsot küldhet |
| 400 | érvénytelen_webhook_endpoint | A kiválasztott webhook-végpont hiányzik vagy inaktív | Válasszon egy aktív végpontot, vagy használja a lekérdezést |
| 401 | érvénytelen_api_kulcs | A hordozó token hiányzik, érvénytelen vagy visszavonva | Ellenőrizze vagy cserélje ki az API-kulcsot |
| 402 | billing_required | A feldolgozás folytatása előtt frissíteni kell a számlázást | Frissítse a számlázást az alkalmazásban |
| 403 | feature_not_available | A munkaterületnek nincs aktív jogosultsága | Válasszon egy tervet, vagy lépjen kapcsolatba az ügyfélszolgálattal |
| 403 | email_not_verified | A tulajdonos vagy a rendszergazda e-mail-címe nincs ellenőrizve | Igazoljon egy jogosult fiókhoz tartozó e-mail-címet |
| 404 | job_not_found | A feladat nem létezik, egy másik munkaterülethez tartozik, vagy lejárt | Állítsa le az állapotlekérdezést, és indítson új rendelést, ha szükséges |
| 404 | batch_not_found | A köteg nem létezik, egy másik munkaterülethez tartozik, vagy lejárt | Állítsa le a lekérdezést, és hozzon létre új köteget, ha szükséges |
| 429 | rate_limited | Elérte a kérési arányt | A tisztelet után |
| 429 | concurrency_limit | Túl sok kérés van feldolgozva egyszerre | Próbálja újra az aktív kérés befejezése után |
| 429 | allowance_exhausted | Elérte a havi karakterkorlátot, és a további használat nem érhető el vagy le van tiltva | Várja meg a következő számlázási időszakot, vagy engedélyezze a további felhasználást egy jogosult csomagban |
| 502 | process_failed | A szolgáltatás nem tudta feldolgozni a szöveget | Ha a probléma fennáll, ismételje meg a kérelmet és forduljon a támogatóhoz a kérés azonosítójával. |
Minden hibát dokumentáld: megismétlhető-e a kérés? Számolják-e az írásokat? Mi van a jegyzőkönyvben? Milyen adatokat igényel a támogatás?