Bonnes pratiques techniques

Lignes directrices techniques pour une intégration optimale.

Consignes pour le téléversement de fichiers

Le respect de ces consignes vous garantira les résultats les plus précis possible, le plus rapidement possible.

Réduire les images de très grande taille

Pour un téléversement et un traitement plus rapides, réduisez la taille des grandes images en les redimensionnant.

Par exemple, les smartphones modernes peuvent prendre des images de 24 mégapixels ou plus ; dans la plupart des cas, c’est complètement inutile, un gaspillage de bande passante et de temps de traitement.

Pour la grande majorité des fichiers image, 3 à 5 mégapixels suffisent. Assurez-vous simplement que le plus petit texte reste lisible.

Nous proposons gratuitement des outils pour compresser et redimensionner des images ou des PDF avant de les envoyer. Détails ici : Charger et ajuster un fichier

Envoyez uniquement ce dont vous avez besoin

Lors du traitement de PDF multipages, dans certains cas, il n’est pas nécessaire d’envoyer toutes les pages pour votre cas d’usage.

Par exemple, sur certains modèles de factures, la dernière page contiendra les conditions générales ; il s’agit généralement d’un texte très dense qui ralentira le traitement (et vous coûtera de l’argent).

Nous proposons gratuitement des outils pour supprimer des pages de PDF avant de les envoyer. Détails ici : Charger et ajuster un fichier

N’agrandissez pas et n’améliorez pas

N’agrandissez jamais une image à basse résolution ; ajouter des pixels ne fait qu’augmenter le temps de traitement sans améliorer la précision. Il est préférable d’éviter les images à très basse résolution, si possible.

Conservez le rapport d’aspect

Ne changez jamais le rapport d’aspect original. Cela créera des distorsions et dégradera les performances de l’OCR.

Utilisez des PDF texte

Les PDF texte (ou natifs) sont plus faciles et plus rapides à traiter. De plus, utiliser un PDF texte offrira une meilleure précision qu’un PDF numérisé (ou image).

Utilisation dans les applications web

Notre consigne officielle pour les applications web est de toujours faire transiter vos requêtes utilisateur par un serveur que vous contrôlez :

• Cela évitera toute fuite de données sensibles.
• Vous pourrez diagnostiquer beaucoup plus facilement tout problème que vos utilisateurs pourraient rencontrer.

À ce titre, nous ne recommandons pas d’utiliser l’API Mindee directement dans une application exécutée dans le navigateur web de l’utilisateur final.

Les utilisateurs pourront trivialement intercepter la clé API utilisée pour les requêtes Mindee et usurper votre compte.

En bref : jamais faites cela. Cela ne fera qu’engendrer des souffrances.

Utilisation dans les applications mobiles

Notre consigne officielle pour les applications mobiles est de privilégier fortement le fait de faire transiter vos requêtes utilisateur par un serveur que vous contrôlez :

• Vous bénéficierez d’une sécurité et d’un contrôle accrus.
• Vous pourrez diagnostiquer beaucoup plus facilement tout problème que vos utilisateurs pourraient rencontrer.

À ce titre, nous ne recommandons pas d’utiliser l’API Mindee directement dans une application exécutée sur l’appareil mobile de l’utilisateur final.

Les utilisateurs peuvent être en mesure d’obtenir votre clé API depuis l’appareil.

Nous recommandons de faire tourner les clés API à intervalles réguliers. Selon la configuration de votre application, la mise à jour des clés API sur l’appareil pourrait poser problème.

Il est possible que les utilisateurs interagissent avec le service Mindee en dehors de votre contrôle. Cela peut entraîner des frais de dépassement inattendus sur votre compte.

Exceptions possibles à cette recommandation :

• Utilisation dans des applications internes sur des appareils ou dans des environnements que vous contrôlez
• La clé API est facilement révocable sur l’appareil, et jamais accessible à l’utilisateur

En bref : à éviter dans la mesure du possible. Utilisez-la uniquement si vous en avez réellement besoin et si vous comprenez les risques encourus.