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
Mesaje de eroare uniforme
{
"error": {
"code": "invalid_request",
"message": "Check the request fields."
}
}Majoritatea erorilor folosesc structura error de mai sus. Răspunsurile de limitare a ratei includ și câmpurile de nivel superior limit, remaining și reset.
{
"error": {
"code": "rate_limited",
"message": "Too many requests."
},
"limit": 1000,
"remaining": 0,
"reset": 1787836800
}Pentru limitările de rată HTTP 429, așteaptă conform antetului Retry-After. allowance_exhausted include în schimb error.details.used, limit și periodEndsAt.
Coduri de eroare
Aceste coduri de eroare folosesc versiunea API 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 5.000 de caractere | Corectaţi cererea |
| 400 | idempotency_key_required | 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 | abonament necesar | 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 interogarea stării și începeți o nouă comandă 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 | limita de conversie | Prea multe cereri sunt procesate în același timp | Reîncercați după ce o solicitare activă se termină |
| 429 | Alocația epuizată | 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 | Repetă cererea și suportul de contact cu ID-ul cererii dacă problema persistă |
Document pentru fiecare eroare: Se poate repeta cererea? Semnele sunt calculate? Ce este în procesul-verbal? De ce informaţii avem nevoie?