Găsiți erorile fără a pierde contextul cererii.
{
"text": "Conținut sursă complex în limba selectată.",
"locale": "ro",
"mode": "simple-language"
}Sunt disponibile exemple SDK și cURL
Envolutul de eroare
Plicul de eroare de producție Versiunea 2 conține un obiect de eroare cu coduri stabile și câmpuri de mesaje.
{
"error": {
"code": "invalid_request",
"message": "Check the request fields."
}
}Obiectul opțional detalii poartă un context care poate fi citit de mașină, cum ar fi retryAfterSeconds.
Antetele de răspuns HTTP conțin metadate de autentificare și reîncercare, acolo unde este cazul.
Catalogul de erori necesare
Următoarele coduri reprezintă contractul actual Versiunea 2.
| HTTP | Codul | Înseamnă | Acțiunea clientului |
|---|---|---|---|
| 400 | invalid_json | Corpul solicitării nu este JSON valid | Corectați corpul JSON |
| 400 | invalid_request | Un câmp lipsește, este necunoscut sau invalid sau textul depășește 10.000 de caractere | Corectaţi cererea |
| 400 | invalid_idempotency_key | O cerere de job sau lot nu are o cheie validă de Idempotence | Trimiteți o cheie unică de cel mult 255 de caractere |
| 400 | invalid_webhook_endpoint | Punctul final de webhook selectat lipsește sau este inactiv | Alegeți un punct final activ sau utilizați sondarea |
| 401 | cheie_api_invalidă | Jetonul Purtător lipsește, este invalid sau este revocat | Verificați sau înlocuiți cheia API |
| 402 | billing_required | Facturarea trebuie actualizată înainte ca procesarea să poată continua | Actualizați facturarea în aplicație |
| 403 | subscription_required | Spațiul de lucru nu are drepturi active | Alegeți un plan sau contactați asistența |
| 403 | email_not_verified | Niciun e-mail de proprietar sau administrator nu este verificat | Verificați e-mailul unui cont eligibil |
| 404 | job_ne_găsit | Jobul nu există, aparține altui spațiu de lucru sau a expirat | Opriți sondajele și creați un nou loc de muncă dacă este necesar |
| 404 | lot_negăsit | Lotul nu există, aparține altui spațiu de lucru sau a expirat | Opriți sondajul și creați un lot nou, dacă este necesar |
| 429 | rate_limited | Rata de solicitare a fost atinsă | Respectă-l după ce te-ai străduit |
| 429 | concurrency_limit | Prea multe cereri sunt procesate în același timp | Reîncercați după ce o solicitare activă se termină |
| 429 | indemnizatie_epuizata | Limita lunară de caractere este atinsă și utilizarea suplimentară este indisponibilă sau dezactivată | Așteptați următoarea perioadă de facturare sau activați utilizarea suplimentară pentru un plan eligibil |
| 502 | procesare_failed | Serviciul nu a putut procesa textul | Reîncercați în siguranță și contactați asistența cu ID-ul solicitării dacă aceasta continuă |
Pentru fiecare eroare, reîncercarea documentului, efectul de facturare, vizibilitatea jurnalului și informațiile de asistență.