> 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/api-overview.md).
# Aperçu de l’intégration
## Description générale
Mindee est idéale pour traiter de grandes quantités de documents. La grande majorité de nos utilisateurs souhaiteront connecter Mindee à leurs systèmes à l'aide de nos API.
Il est ensuite possible de concevoir un grand nombre de cas d'utilisation différents autour du traitement des documents. Ceux-ci peuvent servir à un traitement purement interne ou à offrir aux utilisateurs finaux une expérience soignée.
La simple API HTTP de Mindee est RESTful et renvoie des données au format JSON.
Dans cette section, nous passerons en revue les principales étapes requises pour une intégration réussie et renverrons vers les sections pertinentes de la documentation.
## Avant de commencer
Vous devrez configurer au moins un modèle, voir la [Aperçu des modèles](/v2/fr/models/models-overview.md) section pour plus de détails. Il peut s'agir de n'importe quel type de modèle (extraction ou modèle utilitaire), tous les modèles s'intègrent de manière très similaire.
Nous recommandons d'utiliser la [Live test](/v2/fr/models/live-test.md) fonctionnalité avant de tenter d'intégrer l'API.
Vous aurez également besoin d'au moins une clé API, voir la [Gestion des clés d’API](/v2/fr/integrations/api-keys.md) section pour plus d’informations.
## Comment intégrer
Nous vous recommandons vivement d'utiliser l'un de nos [Bibliothèques clientes / SDK](/v2/fr/integrations/client-libraries-sdk.md).
Ils constituent le moyen le plus rapide et le plus simple d'appeler nos API, et permettent à nos équipes d'assistance de mieux vous aider.
### Bibliothèques clientes
Pour une introduction rapide et du code prêt à copier-coller, consultez [Démarrage rapide Extraction](/v2/fr/modeles-extraction/sdk-integration/quick-start.md) section.
{% hint style="success" %}
**Demander des exemples de code**
Vous pouvez demander des exemples de code précis à l'IA de la documentation.
Utilisez le bouton "Ask" en haut de n'importe quelle page, ou cliquez ci-dessous :
{% endhint %}
Langages/cadres pris en charge : **Python**, **Node.js** (JS/TS), **PHP**, **Ruby**, **Java**, **.NET** (C#).
Nous assurons une prise en charge complète des Bibliothèques clientes, quel que soit votre forfait. Vous pouvez signaler tout problème sur notre [traqueur de bogues](https://feedback.mindee.com/?b=685c08afd7a1d2e47b124cbb) ou directement sur [GitHub](https://github.com/orgs/mindee/repositories).
### No-code ou low-code
Si vous intégrez à l'aide d'une plateforme no-code ou low-code, jetez un œil à la [Intégration no-code](/v2/fr/modeles-extraction/no-code-integration.md) section.
### Intégration manuelle
Si aucune des options ci-dessus ne correspond à vos besoins, jetez un œil à la [Intégration manuelle](/v2/fr/integrations/api-reference.md) section.
{% hint style="warning" %}
**Nous ne recommandons pas d’intégrer manuellement**, et ne pouvons pas garantir une prise en charge complète.
Les forfaits Pro et supérieurs bénéficient d’une prise en charge étendue des intégrations.
{% endhint %}
## Quoi envoyer
Vous pouvez envoyer soit un fichier local, soit une URL ; cela ne fait aucune différence pour le traitement côté serveur.
Cependant, lorsque vous utilisez nos bibliothèques clientes, vous pouvez [Charger et ajuster un fichier](/v2/fr/integrations/client-libraries-sdk/load-and-adjust-a-file.md#adjust-the-source-file) si vous l'avez en local.
## Comment recevoir les résultats
Les opérations d'inférence sont toujours asynchrones, ce qui signifie qu'il existe une route pour envoyer le fichier en POST et un autre mécanisme pour récupérer les résultats.
Vous pouvez choisir d'utiliser soit le flux d'interrogation, soit le flux de webhook.
[Interrogation des résultats](/v2/fr/integrations/polling-for-results.md) - utilise une route GET et convient mieux aux tests et aux petits volumes.
[Résultats des webhooks](/v2/fr/integrations/webhooks.md) - envoie directement à votre serveur et convient davantage à une utilisation intensive en production.
## Développement et tests
Un cycle de vie de publication typique pourrait ressembler à ceci :
1. Commencez avec un nouveau modèle. Si vous apportez des ajustements à un modèle de production existant, nous vous recommandons d'en faire une copie et de n'apporter des modifications qu'à la copie.\
Envisagez d'ajouter des informations de version au nom du modèle copié, par exemple « Invoices v1.1 » ou « Receipts 2026-05-17 ».
2. Ajustez votre code si nécessaire et testez.
3. Lorsque vous déployez votre code dans des environnements de test ou de production, utilisez l'ID du nouveau modèle.
4. Après le déploiement, [verrouillez votre modèle de production](/v2/fr/models/model-settings.md#locking-the-data-schema) afin d'éviter toute modification accidentelle.
5. `Aller à 1`
Remarque : nous ne fournissons pas d'environnements séparés pour le développement, la préproduction, la production, etc.
---
# 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/api-overview.md?ask=
```
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.