> 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 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` 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 optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.