> For the complete documentation index, see [llms.txt](https://docs.mindee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mindee.com/v2/fr/integrations/technical-guidelines.md). # Bonnes pratiques techniques Consignes techniques pour une intégration optimale. ## Consignes pour le téléversement de fichiers Le respect de ces consignes vous permettra d'obtenir les résultats les plus précis possible, le plus rapidement possible. ### **Réduisez les images très volumineuses** 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, cela est totalement 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 est lisible. Nous proposons des outils gratuits pour compresser et redimensionner les images ou les PDF avant de les envoyer.\ Détails ici : [Charger et ajuster un fichier](/v2/fr/integrations/client-libraries-sdk/load-and-adjust-a-file.md#compress-files) ### **N'envoyez que ce dont vous avez besoin** Lors du traitement de PDF multipages, dans certains cas, toutes les pages ne doivent pas être envoyées pour votre cas d'utilisation. Par exemple, sur certains modèles de facture, la dernière page sera consacrée aux 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 des outils gratuits pour supprimer des pages des PDF avant de les envoyer.\ Détails ici : [Charger et ajuster un fichier](/v2/fr/integrations/client-libraries-sdk/load-and-adjust-a-file.md#manipulate-pdf-pages) ### **N'agrandissez ni n'améliorez** N'agrandissez jamais une image à faible résolution ; ajouter des pixels supplémentaires 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 faible résolution, si possible. ### **Conservez le rapport hauteur/largeur** Ne modifiez jamais le rapport hauteur/largeur original. Cela créerait des distorsions et dégraderait les performances de l'OCR. ### Utilisez des PDF texte lorsque c'est possible Les PDF texte (ou natifs) sont plus faciles et plus rapides à traiter. De plus, l'utilisation d'un PDF texte offrira une meilleure précision qu'un PDF image ou qu'un fichier image. Si la fourniture de PDF texte n'est pas possible, le format suivant le plus adapté serait [des PDF numérisés](#scans-are-better-than-photos). ### Les scans sont meilleurs que les photos Si possible, fournir des images numérisées peut donner de meilleurs résultats que des photos (généralement prises avec un téléphone). **Cela ne signifie pas que les photos ne fonctionneront pas bien**, Mindee compte de nombreux grands utilisateurs chez qui les photos (notamment de reçus et de documents d'identité) constituent le principal cas d'utilisation. Pour des documents simples, la différence est généralement négligeable, si l'on exclut les erreurs utilisateur comme des photos floues ou tronquées. En revanche, si vous traitez des documents complexes comme des relevés bancaires ou des factures multipages, les scans comportent généralement moins d'erreurs en moyenne. ## Utilisation dans les applications web Notre consigne officielle pour les applications web est de **toujours** faire transiter les requêtes de vos utilisateurs par un serveur que vous contrôlez : * Cela empêchera la fuite de données sensibles. * Vous pourrez beaucoup plus facilement diagnostiquer les problèmes que vos utilisateurs pourraient rencontrer. Par conséquent, nous **déconseillons** d'utiliser l'API Mindee **directement** dans une application exécutée dans le navigateur web de l'utilisateur final. Les utilisateurs pourront **aisément** intercepter la clé API utilisée pour les requêtes Mindee et usurper votre compte. {% hint style="info" %} **En bref : *****jamais***** faites cela**. Cela ne fera que causer de la souffrance. {% endhint %} ## Utilisation dans les applications mobiles Notre consigne officielle pour les applications mobiles est de privilégier fortement le fait de faire transiter les requêtes de vos utilisateurs par un serveur que vous contrôlez : * Vous bénéficierez d'une sécurité et d'un contrôle accrus. * Vous pourrez beaucoup plus facilement diagnostiquer les problèmes que vos utilisateurs pourraient rencontrer. Par conséquent, nous **déconseillons** d'utiliser l'API Mindee **directement** dans une application exécutée sur l'appareil mobile de l'utilisateur final. Les utilisateurs pourraient être en mesure d'obtenir votre clé API à partir de l'appareil. Nous recommandons de faire tourner les clés API à intervalles réguliers. Selon la configuration de votre application, il pourrait être problématique de mettre à jour les clés API sur l'appareil. 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 peut être révoquée facilement sur l'appareil, et *jamais* accessible à l'utilisateur {% hint style="info" %} **En bref : à éviter dans la mesure du possible**. À n'utiliser que si vous en avez réellement besoin et comprenez les risques encourus. {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.mindee.com/v2/fr/integrations/technical-guidelines.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.