Erreurs

Chaque échec d’API utilise une structure d’enveloppe unique. Basez vos conditions sur error.code et jamais sur le message lisible par l’humain.

{
  "error": {
    "type": "permission_error",
    "code": "insufficient_scope",
    "message": "Ce jeton n'a pas le scope batches:write.",
    "docs_url": "https://ai-glot.com/docs/api/errors#insufficient_scope"
  },
  "request_id": "req_example"
}

Codes de statut

Codes d’authentification et de permission

authentication_required

Aucun jeton Bearer n’a été envoyé. Ajoutez l’en-tête Authorization.

invalid_api_key

La clé est malformée ou inconnue. Vérifiez que la valeur complète aig_live_… a bien été copiée.

api_key_expired

La clé a atteint sa date d’expiration. Créez-en une nouvelle ou utilisez un remplaçant.

api_key_revoked

Un administrateur a révoqué ou renouvelé cette clé. Mettez à jour l’intégration avec un identifiant actif.

insufficient_scope

L’identifiant est authentifié mais ne possède pas le scope requis pour cette opération.

feature_not_available

Le forfait de l’espace de travail ou la version actuelle de la plateforme ne comprend pas la fonctionnalité demandée.

admin_required

Seul un administrateur de l’espace de travail peut effectuer cette opération.

Codes de requête

invalid_request

La requête ne peut pas être analysée ou ne correspond pas au contrat de l’endpoint.

unknown_field

Une propriété du corps JSON n’est pas reconnue. Corrigez l’orthographe plutôt que de supprimer la validation. Les paramètres de requête non reconnus ne produisent jamais cette erreur ; ils sont ignorés, donc un filtre mal orthographié renvoie un code 200 sans filtre.

invalid_parameter

Un paramètre a un type, une plage ou un format incorrect.

invalid_cursor

Le curseur de pagination est invalide. Réutilisez next_cursor exactement tel qu’il a été renvoyé.

request_too_large

Le corps de la requête dépasse la limite stricte de l’endpoint.

Codes de ressource et d’état

batch_not_found

Aucune traduction visible ne possède cet ID. Les ressources appartenant à un autre espace de travail renvoient intentionnellement la même erreur.

glossary_not_found

Aucun glossaire n’existe pour cette paire de langues.

resource_not_found

La ressource ou la route demandée n’existe pas.

glossary_already_exists

Un glossaire existe déjà pour cette paire de langues. Mettez-le à jour au lieu d’en créer un nouveau.

result_not_ready

La traduction n’est pas terminée, le résultat ne peut donc pas encore être téléchargé.

batch_not_editable

L’état actuel de la traduction ne permet pas la modification administrative demandée.

Codes de langue et de glossaire

language_not_supported

Le tag ne fait pas partie du catalogue supporté. Consultez GET /v1/languages.

invalid_language_pair

L’identifiant de la paire de langues ne peut pas être divisé en deux tags BCP 47 supportés.

glossary_term_limit_reached

Le nombre de termes résultant dépasserait le quota du forfait de l’espace de travail. La mise à jour est atomique ; rien n’a été modifié.

glossary_limit_reached

L’espace de travail a atteint le nombre maximal de glossaires autorisés pour le forfait actuel.

invalid_glossary_terms

Une ou plusieurs entrées du glossaire sont vides, incomplètes ou invalides.

Codes de service

rate_limited

L’identifiant a dépassé la limite de requêtes. Attendez le délai Retry-After, puis retentez avec un jitter.

internal_error

AI Glot a rencontré une erreur inattendue. Retentez avec un backoff et conservez le request_id.

service_unavailable

Un service requis est temporairement indisponible. Retentez avec un backoff.