Errori
Gestisci gli errori delle API di AI Glot usando codici di errore stabili, ID richiesta, indicazioni per i tentativi ed esplicazioni dettagliate per ogni errore documentato.
Tutti gli errori dell’API seguono lo stesso formato. Usa error.code per determinare come gestire l’errore, mai il messaggio leggibile.
{
"error": {
"type": "permission_error",
"code": "insufficient_scope",
"message": "This credential is missing the batches:write scope.",
"docs_url": "https://ai-glot.com/docs/api/errors#insufficient_scope"
},
"request_id": "req_example"
}Codici di stato
| Status | Meaning | What to do |
|---|---|---|
| 400 | Richiesta non valida o campo sconosciuto | Correggi la richiesta |
| 401 | Credenziale assente, non valida, scaduta o revocata | Sostituiscila o rinnovala |
| 403 | Autenticazione riuscita, ma operazione non consentita | Concedi l’ambito o la funzionalità richiesta |
| 404 | Risorsa assente o esterna a questo workspace | Controlla l’ID e il workspace |
| 409 | Lo stato attuale è in conflitto 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 richieste raggiunto | Attendi Retry-After |
| 500/503 | AI Glot ha riscontrato un errore o è temporaneamente non disponibile | Riprova aumentando gradualmente l’intervallo |
Codici di autenticazione e autorizzazione
authentication_required
Non è stata inviata alcuna credenziale bearer. Aggiungi l’header Authorization.
invalid_api_key
La chiave non è valida o non è riconosciuta. Verifica di aver copiato l’intero valore aig_live_….
api_key_expired
La chiave ha raggiunto la scadenza configurata. Creane o utilizzane una sostitutiva.
api_key_revoked
Un amministratore ha revocato o ruotato questa chiave. Aggiorna l’integrazione con una credenziale attiva.
insufficient_scope
La credenziale è stata autenticata, ma non dispone dell’ambito richiesto da questa operazione.
feature_not_available
Il piano del workspace o la versione attuale della piattaforma non include 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 oppure non rispetta il contratto dell’endpoint.
unknown_field
Una proprietà del corpo JSON non è riconosciuta. Correggi l’ortografia invece di rimuovere la convalida. I parametri di query non riconosciuti non generano mai questo errore: vengono ignorati, quindi un filtro digitato in modo errato restituisce un 200 senza filtri.
invalid_parameter
Un parametro ha tipo, intervallo o formato errato.
invalid_cursor
Il cursore di paginazione non è valido. Riutilizza 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 corrisponde a questo ID. Le risorse di un altro workspace restituiscono intenzionalmente lo stesso errore.
glossary_not_found
Non esiste un glossario per questa coppia di lingue.
resource_not_found
La risorsa o la route richiesta non esiste.
glossary_already_exists
Esiste già un glossario per questa coppia di lingue. Aggiornalo invece di crearne un altro.
result_not_ready
La traduzione non è terminata, quindi non è ancora possibile scaricare il risultato.
batch_not_editable
Lo stato attuale della traduzione non consente la modifica amministrativa richiesta.
Codici di file e formato
unsupported_format
L’estensione del file non è tra quelle accettate da AI Glot. Consulta File e formati per l’elenco completo dei formati e delle relative estensioni.
file_too_large
Il file supera il limite previsto per il suo formato. I limiti variano in base al formato, non sono globali (60 MB per CSV, 4 MB per un catalogo PO), quindi una dimensione accettata per un’estensione può essere rifiutata per un’altra.
file_fetch_failed
Non è stato possibile recuperare file_url. L’URL deve usare HTTPS e puntare alla destinazione finale: i reindirizzamenti non vengono seguiti, quindi un link abbreviato o reindirizzato dopo la firma non funziona.
file_retention_expired
Il periodo di conservazione del file caricato è terminato e il file non è più archiviato. Crea nuovamente la traduzione a partire dal file sorgente.
file_expired
Il file alla base di questa traduzione non è più disponibile, quindi non è possibile procedere.
result_too_large
La traduzione completata supera le dimensioni massime restituibili. Dividi il file sorgente e traducilo in più parti.
Codici di piano e approvazione
plan_invalid
Non è stato possibile trasformare l’istruzione o il perfezionamento in un piano utilizzabile. Riformulala: indicare i campi o le colonne da tradurre è più affidabile che descriverli.
no_plan_yet
È stata tentata l’approvazione prima che esistesse un piano. Chiama prima POST /v1/batches/{batch_id}/plan: questo controllo impedisce che un’integrazione addebiti al workspace una traduzione mai descritta.
batch_not_awaiting_approval
La traduzione non si trova in uno stato che prevede l’approvazione; di solito è già in corso o completata. Controlla GET /v1/batches/{batch_id} invece di approvarla di nuovo.
insufficient_credits
Il saldo del workspace non copre il costo calcolato del piano. Non viene riservato alcun credito, quindi sarà possibile approvare la traduzione dopo averne aggiunti.
Codici di lingua e glossario
language_not_supported
Il tag non è incluso nel catalogo delle lingue supportate. Consulta GET /v1/languages.
invalid_language_pair
L’identificatore della coppia di lingue 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: non è stata apportata alcuna modifica.
glossary_limit_reached
Il workspace ha raggiunto il numero massimo di glossari previsto dal piano attuale.
invalid_glossary_terms
Una o più voci del glossario sono vuote, incomplete o non valide per altri motivi.
Codici di servizio
rate_limited
La credenziale ha superato il limite previsto per una finestra temporale. Attendi Retry-After, quindi riprova con jitter.
internal_error
AI Glot ha riscontrato un errore imprevisto. Riprova aumentando gradualmente l’intervallo e conserva request_id.
service_unavailable
Un servizio necessario è temporaneamente non disponibile. Riprova aumentando gradualmente l’intervallo.