> 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éal 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 possible de concevoir un nombre quelconque de cas d'usage différents autour du traitement de documents. Ceux-ci peuvent être destinés à un traitement purement interne ou à offrir aux utilisateurs finaux une expérience soignée.
L'API est asynchrone, RESTful et renvoie des objets.
## Avant de commencer
Vous aurez besoin d'au moins un modèle configuré, consultez la [Aperçu des modèles](/v2/fr/models/models-overview.md) section pour plus de détails. Cela peut être n'importe quel type de modèle (modèle d'extraction ou utilitaire) ; tous les modèles sont intégrés de manière très similaire.
Nous recommandons d'utiliser la [Live test](/v2/fr/models/live-test.md) fonctionnalité avant d'essayer d'intégrer l'API.
Vous aurez également besoin d'au moins une clé API, consultez la [Gérer les clés API](/v2/fr/integrations/api-keys.md) section pour plus d'informations.
## Comment intégrer
Toutes les routes de traitement de fichiers sont asynchrones ; aucune route synchrone n'est fournie. Vous pouvez utiliser un workflow de polling ou de webhook.
Si vous utilisez nos intégrations SDK, le polling est abstrait pour vous, ce qui signifie que vous pouvez utiliser une seule méthode synchrone au sein du SDK pour recevoir les résultats de traitement.
Ce sont les moyens les plus rapides et les plus simples d'appeler nos API, et ils permettent à nos équipes d'assistance de mieux vous aider.
### Bibliothèques clientes / SDK
Pour une introduction rapide et du code prêt à copier-coller, consultez la [Démarrage rapide de l'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 spécifiques à l'IA de la documentation.
Utilisez le bouton « Demander » en haut de n'importe quelle page, ou cliquez ci-dessous :
{% endhint %}
Langages/frameworks pris en charge : **Python**, **Node.js** (JS/TS), **PHP**, **Ruby**, **Java**, **.NET** (C#).
Nous fournissons une assistance complète pour les bibliothèques clientes, quel que soit votre forfait. Vous pouvez signaler tout problème sur notre [outil de suivi des bugs](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, consultez la [Intégration no-code](/v2/fr/modeles-extraction/no-code-integration.md) section.
### Intégration manuelle
{% hint style="warning" %}
**Nous ne recommandons pas d'intégrer manuellement**et nous ne pouvons pas garantir une assistance complète.
Les offres Pro et supérieures bénéficient d'une assistance d'intégration étendue.
{% endhint %}
Ce n'est que s'il n'est pas possible d'intégrer à l'aide d'un SDK ou du no-code, consultez le [Intégration manuelle](/v2/fr/integrations/api-reference.md) section.
## Ce qu'il faut 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 de polling, soit le flux de webhook.
[Utilisation du polling](/v2/fr/integrations/polling-for-results.md) - utilise une route GET et est mieux adapté aux tests et aux petits volumes.
[Utilisation des webhooks](/v2/fr/integrations/webhooks.md) - envoie directement vers votre serveur et convient mieux à une utilisation intensive en production.
## Développement et test
Un cycle de publication de développement 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 ne modifier que la copie.\
Pensez à ajouter des informations de version dans le nom du modèle copié, par exemple « Factures v1.1 » ou « Reçus 2026-05-17 ».
2. Ajustez votre code selon les besoins, puis testez-le.
3. Lorsque vous déployez votre code vers 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) pour éviter toute modification accidentelle.
5. `RETOUR À 1`
## Foire aux questions
Puis-je utiliser les mêmes clés API V1 dans la V2 ?
Non, V1 et V2 ne partagent pas les informations de clé API.
Puis-je exécuter V1 et V2 en parallèle ?
Oui, absolument.
L'exécution des deux plateformes en parallèle n'est pas seulement prise en charge, elle est même recommandée si vous migrez de V1 vers V2.
Tous les SDK prennent entièrement en charge l'exécution parallèle de V1 et V2 ; plus d'informations ici : [Bibliothèques clientes / SDK](/v2/fr/integrations/client-libraries-sdk.md)
Proposez-vous un environnement de test ou de préproduction ?
Nous ne fournissons pas d'environnements séparés pour le développement, la préproduction, la production, etc.
Pour obtenir des informations sur le test de vos modèles et de votre code avant le déploiement en production, consultez : [#developing-and-testing](#developing-and-testing "mention")
Comment puis-je exporter les résultats en CSV ?
La réponse de l'API Mindee contient des listes de champs imbriqués ; il s'agit d'un format basé sur des objets.\
Le format CSV ne prévoit pas les objets ; il ne contient que des lignes et des colonnes.
Pour convertir le format objet de Mindee en format CSV, vous pouvez soit supprimer des informations, soit produire plusieurs fichiers CSV (ou feuilles).
Comme chaque modèle est différent et que chaque cas d'usage est différent, il n'existe pas de méthode universelle pour effectuer cette conversion.
C'est à vous de créer un mappage conforme à vos besoins. Vous pouvez utiliser les [SDK](/v2/fr/modeles-extraction/sdk-integration.md) pour manipuler facilement des objets, ou définir des règles de mappage dans votre [no-code](/v2/fr/modeles-extraction/no-code-integration.md) solution.
---
# 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/api-overview.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.