Gestire gli errori senza perdere il contesto della richiesta.
{
"text": "Contenuti originali complessi nella lingua selezionata.",
"locale": "it",
"mode": "simple-language"
}Esempi di SDK e cURL disponibili
Messaggi di errore uniformi
{
"error": {
"code": "invalid_request",
"message": "Check the request fields."
}
}La maggior parte degli errori usa la struttura error riportata sopra. Le risposte di limitazione della frequenza includono anche i campi di primo livello limit, remaining e reset.
{
"error": {
"code": "rate_limited",
"message": "Too many requests."
},
"limit": 1000,
"remaining": 0,
"reset": 1787836800
}Per le limitazioni di frequenza HTTP 429, attendi in base all'header Retry-After. allowance_exhausted include invece error.details.used, limit e periodEndsAt.
Codici di default
Questi codici di errore utilizzano la versione API 2:
| HTTP | Codice | Significa | Azione del cliente |
|---|---|---|---|
| 400 | invalid_json | Il corpo della richiesta non è un JSON valido | Correggere il corpo JSON |
| 400 | invalid_request | Un campo è mancante, sconosciuto o non valido oppure il testo supera i 5.000 caratteri | Correzione della richiesta |
| 400 | invalid_idempotenza_key | Una richiesta di lavoro o batch non ha una chiave di idempotenza valida | Invia una chiave univoca composta da un massimo di 255 caratteri |
| 400 | endpoint_webhook_invalido | L'endpoint del webhook selezionato è mancante o inattivo | Scegli un endpoint attivo o utilizza il polling |
| 401 | invalid_api_key | Il token al portatore è mancante, non valido o revocato | Controlla o sostituisci la chiave API |
| 402 | fatturazione_richiesto | La fatturazione deve essere aggiornata prima che l'elaborazione possa continuare | Aggiorna la fatturazione nell'applicazione |
| 403 | abbonamento richiesto | L'area di lavoro non ha alcun diritto attivo | Scegli un piano o contatta l'assistenza |
| 403 | email_non_verificata | Nessun indirizzo email del proprietario o dell'amministratore è verificato | Verifica l'e-mail di un account idoneo |
| 404 | lavoro_non_trovato | Il lavoro non esiste, appartiene a un altro spazio di lavoro o è scaduto | Interrompere la query di stato e avviare un nuovo ordine se necessario |
| 404 | lotto_non_trovato | Il batch non esiste, appartiene a un altro workspace o è scaduto | Interrompi il polling e crea un nuovo batch, se necessario |
| 429 | tariffa_limitata | Il tasso di richiesta è stato raggiunto | Rispettate dopo aver cercato di tornare |
| 429 | limite di concorrenza | Troppe richieste vengono elaborate contemporaneamente | Riprovare al termine di una richiesta attiva |
| 429 | indennità esaurita | È stato raggiunto il limite di caratteri mensile e l'utilizzo aggiuntivo non è disponibile o è disabilitato | Attendi il periodo di fatturazione successivo o abilita un utilizzo aggiuntivo su un piano idoneo |
| 502 | processing_failed | Il servizio non è riuscito a elaborare il testo | Riprova la richiesta e contatta l'assistenza se il problema persiste |
Documento per ogni errore: la richiesta può essere ripetuta? I segni sono calcolati? Cosa c'è nel processo verbale? Quali informazioni necessitano di supporto?