Errori
Gestisci i fallimenti delle API di AI Glot utilizzando codici di errore stabili, ID richiesta.
Ogni fallimento dell’API utilizza un unico involucro. Effettua il branching su error.code, mai sul messaggio leggibile dall’utente.
{
"error": {
"type": "permission_error",
"code": "insufficient_scope",
"message": "Questa credenziale non dispone dello scope batches:write.",
"docs_url": "https://ai-glot.com/docs/api/errors#insufficient_scope"
},
"request_id": "req_example"
}Codici di stato
| Stato | Significato | Cosa fare |
|---|---|---|
| 400 | Richiesta malformata o campo sconosciuto | Correggi la richiesta |
| 401 | Credenziale mancante, non valida, scaduta o revocata | Sostituiscila o rinnovala |
| 403 | Autenticato ma non autorizzato | Concedi lo scope o la funzionalità richiesta |
| 404 | Risorsa assente o fuori da questo workspace | Verifica l’ID e il workspace |
| 409 | Lo stato attuale confligge con la richiesta | Leggi la risorsa, poi decidi |
| 413 | Corpo della richiesta troppo grande | Invia un corpo più piccolo |
| 422 | Valore ben formato ma non valido | Correggi il valore indicato |
| 429 | Limite di frequenza superato | Attendi l’indicazione di Retry-After |
| 500/503 | AI Glot ha riscontrato un errore o non è temporaneamente disponibile | Riprova con backoff |
Codici di autenticazione e permessi
authentication_required
Nessuna credenziale bearer è stata inviata. Aggiungi l’header Authorization.
invalid_api_key
La chiave è malformata o sconosciuta. Verifica che l’intero valore aig_live_… sia stato copiato.
api_key_expired
La chiave ha raggiunto la data di scadenza configurata. Crea o utilizza una sostitutiva.
api_key_revoked
Un amministratore ha revocato o ruotato questa chiave. Aggiorna l’integrazione con una credenziale attiva.
insufficient_scope
La credenziale è autenticata ma non dispone dello scope richiesto per questa operazione.
feature_not_available
Il piano del workspace o la versione attuale della piattaforma non includono la funzionalità richiesta.
admin_required
Solo un amministratore del workspace può eseguire l’operazione.
Codici di richiesta
invalid_request
La richiesta non può essere analizzata o non corrisponde al contratto dell’endpoint.
unknown_field
Una proprietà del corpo JSON non è riconosciuta. Correggi l’ortografia invece di rimuovere la validazione. I parametri di query non riconosciuti non producono mai questo errore; vengono ignorati, quindi un filtro scritto erroneamente restituirà un risultato 200 non filtrato.
invalid_parameter
Un parametro ha un tipo, un intervallo o un formato errato.
invalid_cursor
Il cursore di paginazione non è valido. Riusa next_cursor esattamente come restituito.
request_too_large
Il corpo della richiesta supera il limite massimo dell’endpoint.
Codici di risorsa e stato
batch_not_found
Nessuna traduzione visibile possiede quell’ID. Le risorse in un altro workspace restituiscono intenzionalmente lo stesso errore.
glossary_not_found
Non esiste alcun glossario per quella coppia linguistica.
resource_not_found
La risorsa o l’indirizzo richiesto non esiste.
glossary_already_exists
Esiste già un glossario per questa coppia linguistica. Aggiornalo invece di crearne un altro.
result_not_ready
La traduzione non è stata completata, quindi il risultato non può ancora essere scaricato.
batch_not_editable
Lo stato attuale della traduzione non consente la modifica di manutenzione richiesta.
Codici lingua e glossario
language_not_supported
Il tag non è presente nel catalogo supportato. Consulta GET /v1/languages.
invalid_language_pair
L’identificatore della coppia linguistica non può essere suddiviso in due tag BCP 47 supportati.
glossary_term_limit_reached
Il numero di termini risultante supererebbe il limite previsto dal piano del workspace. L’aggiornamento è atomico; nulla è stato modificato.
glossary_limit_reached
Il workspace ha raggiunto il numero massimo di glossari previsti per il piano corrente.
invalid_glossary_terms
Una o più voci del glossario sono vuote, incomplete o altrimenti non valide.
Codici di servizio
rate_limited
La credenziale ha superato la finestra di frequenza. Attendi Retry-After, quindi riprova con jitter.
internal_error
AI Glot ha riscontrato un errore imprevisto. Riprova con backoff e conserva il request_id.
service_unavailable
Un servizio richiesto è temporaneamente non disponibile. Riprova con backoff.