> 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 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](/v2/fr/integrations/client-libraries-sdk/load-and-adjust-a-file.md#compress-files)

### **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](/v2/fr/integrations/client-libraries-sdk/load-and-adjust-a-file.md#manipulate-pdf-pages)

### **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.

{% hint style="info" %}
**En bref : *****jamais***** faites cela**. Cela ne fera qu’engendrer des souffrances.
{% endhint %}

## 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

{% hint style="info" %}
**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.
{% 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:

```
GET https://docs.mindee.com/v2/fr/integrations/technical-guidelines.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.