Choisir une API d'OCR : la liste de contrôle du développeur

Intégrer une API documentaire est un engagement de longue durée : elle finit dans votre logique de reprise, vos alertes et vos procédures d'incident. La précision du modèle est ce dont parle la page marketing, et c'est rarement ce qui vous coûtera un week-end.

L'API EasyInvoiceOCR arrive prochainement

Soyons clairs avant d'aller plus loin : notre propre API n'est pas encore disponible. Elle est annoncée mais non opérationnelle, elle n'accepte aucune requête à ce jour, et cet article n'en fait pas la promotion. La liste ci-dessous est celle que nous vous invitons à opposer à n'importe quel éditeur — nous compris, le jour où le point d'entrée ouvrira.

Ce qu'il faut trouver dans la documentation

Si l'un de ces éléments est absent de la documentation publique, considérez qu'il est absent du produit. Il est bien plus rare qu'on ne le laisse entendre qu'une documentation omette une fonctionnalité réellement présente.

• Un format d'erreur stable, avec des codes exploitables par la machine, et non des messages en prose qui changent d'une version à l'autre.
• Des clés d'idempotence à l'envoi, pour qu'une reprise après expiration ne crée pas un document en double.
• Des en-têtes de limitation explicites et un Retry-After documenté, plutôt qu'un 429 laissé sans explication.
• Un versionnage par en-tête ou par segment d'URL, assorti d'une politique de dépréciation écrite.
• Une pagination par curseur sur les listes ; la pagination par décalage saute et répète des lignes dès qu'il y a des écritures concurrentes.

Testez d'abord les chemins d'échec

Envoyez un PDF corrompu, un fichier protégé par mot de passe, un fichier vide et une page blanche avant de tester le cas nominal. La manière dont une API échoue en dit bien plus long sur l'ingénierie qui la porte que la manière dont elle réussit, et vous passerez plus de temps que prévu dans ces branches-là.

Demandez où va le document

La liste opérationnelle et la liste « protection des données » ne font qu'une. Durée de conservation, entraînement sur les données clients et sous-traitants ultérieurs relèvent de la décision d'intégration, pas d'une revue postérieure.