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
Involucro di errore
La busta di errore di produzione della Versione 2 contiene un oggetto di errore con codice stabile e campi di messaggio.
{
"error": {
"code": "invalid_request",
"message": "Check the request fields."
}
}L'oggetto dettagli facoltativo contiene un contesto leggibile dalla macchina come retryAfterSeconds.
Le intestazioni di risposta HTTP trasportano l'autenticazione e riprovano i metadati ove applicabile.
Catalogo degli errori richiesti
I seguenti codici rappresentano l'attuale contratto della Versione 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 10.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 | Interrompi il sondaggio e crea un nuovo lavoro 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_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 in tutta sicurezza e, se il problema persiste, contatta l'assistenza con l'ID della richiesta |
Per ogni errore, riprovabilità del documento, effetto di fatturazione, visibilità del registro e informazioni di supporto.