Erreurs et bonnes pratiques

Codes d’erreur communs

Le détail des erreurs de chaque point de terminaison figure sur sa page.

Code	Motif
400	Paramètre manquant ou invalide
401	En-tête `Authorization` absent / mauvais
404	Agent introuvable pour la société
409	Réinitialisation pendant une réponse, ou document au même `externalId` encore en cours d’envoi ou d’ingestion
413	Fichier trop volumineux
415	Type de fichier non pris en charge
422	Document sans texte exploitable
429	Trop de requêtes sur la base documentaire (réessayez après l’en-tête `Retry-After`)
500	Erreur interne inattendue

Timeout côté client : pour le mode stream, coupez la connexion si aucun chunk n’est reçu depuis >20 s.
Réessais : en cas de 500 réessayez avec back-off exponentiel.
Sécurité : stockez l’API_TOKEN côté serveur uniquement.