Dépannage

Référence des Erreurs

Un guide complet pour gérer les erreurs API avec élégance. Nous utilisons des codes HTTP standard enrichis d'un contexte JSON détaillé.

Format d'Erreur Standard

Toutes les réponses d'erreur renvoient un objet JSON standardisé. Le champ detail contient des informations structurées pour vous aider à déboguer ou à afficher des messages conviviaux.

structure-erreur.json

{
  "detail": {
    "error": "INVALID_FILE_TYPE",
    "message": "Type de fichier non pris en charge. Veuillez télécharger un fichier PDF, DOCX ou TXT.",
    "suggestion": "Convertissez votre fichier en PDF, DOCX ou TXT et réessayez.",
    "severity": "medium",
    "technical_details": "Type MIME détecté : application/octet-stream"
  }
}

Référence des Erreurs

Erreurs de Validation

100-199

VALIDATION_ERROR

Échec de validation général.

INVALID_INPUT

Le format d'entrée fourni est incorrect.

MISSING_FIELD

Un champ obligatoire est manquant dans la charge utile.

Erreurs d'Authentification

200-299

AUTH_ERROR

L'authentification a échoué.

INVALID_API_KEY

La clé API fournie est invalide ou désactivée.

API_KEY_EXPIRED

La clé API a expiré.

INSUFFICIENT_PERMISSIONS

La clé API n'a pas la permission d'accéder à cette ressource.

Erreurs de Téléchargement de Fichier

300-399

INVALID_FILE_TYPE

Seuls les fichiers PDF, DOCX et TXT sont pris en charge.

FILE_TOO_LARGE

Le fichier dépasse la limite de taille maximale (5 Mo).

FILE_CORRUPTED

Le fichier n'a pas pu être lu ou est corrompu.

PDF_QUALITY_ISSUE

Le PDF contient des images numérisées ou du texte illisible.

Limitation de Débit

400-499

RATE_LIMIT_EXCEEDED

Trop de requêtes sur une courte période.

QUOTA_EXCEEDED

Le quota API mensuel a été atteint.

Erreurs Serveur

500-799

PARSING_FAILED

Le moteur d'analyse n'a pas réussi à traiter le document.

AI_PROCESSING_FAILED

Le modèle IA a rencontré une erreur lors de l'analyse du contenu.

INTERNAL_ERROR

Une erreur serveur interne inattendue s'est produite.

SERVICE_UNAVAILABLE

Le service est temporairement indisponible.

Besoin d'aide pour le débogage ?

Si vous rencontrez une INTERNAL_ERROR de manière cohérente, veuillez contacter le support avec l'ID de demande et l'horodatage. Notez que AI_PROCESSING_FAILED peut se produire si le contenu d'entrée est trop ambigu ou viole les politiques de sécurité.