> 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

Aperçu de la connexion de votre système à l’API Mindee.

## Description générale

Mindee est idéal pour gérer 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 illimité de cas d’utilisation 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 (extraction ou modèle utilitaire), tous les modèles s’intègrent de manière très similaire.

Nous vous 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 flux de travail de polling ou de webhook.

Si vous utilisez nos intégrations SDK, le polling est pris en charge pour vous, ce qui signifie que vous pouvez utiliser une unique méthode synchrone dans le SDK pour recevoir les résultats du 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 documentation.

Utilisez le bouton « Demander » en haut de n’importe quelle page, ou cliquez ci-dessous :

<button type="button" class="button primary" data-action="ask" data-query="List available model types and a brief description (Extraction, Split, Crop, Classify, OCR), allow to pick one. Then list available SDK languages and allow to pick one. Finally ask for model ID, and generate the code sample for polling." data-icon="gitbook-assistant">Demandez « Écrivez-moi un exemple de code. »</button>
{% endhint %}

Langages/frameworks pris en charge : **Python**, **Node.js** (JS/TS), **PHP**, **Ruby**, **Java**, **.NET** (C#).

Nous offrons 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 via 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 forfaits Pro et supérieurs bénéficient d’une assistance étendue à l’intégration.
{% endhint %}

Ce n’est que s’il n’est pas possible d’intégrer à l’aide d’un SDK ou en no-code, consultez la [Intégration manuelle](/v2/fr/integrations/api-reference.md) section.

## Quoi envoyer

Vous pouvez envoyer soit un fichier local, soit une URL ; cela ne fait aucune différence pour le traitement côté serveur.

Toutefois, 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.

## Récupération des résultats

Le traitement est toujours asynchrone, ce qui signifie que la récupération des résultats est distincte de l’envoi du fichier au serveur.

Une fois une requête envoyée, il n’est pas possible d’arrêter ou d’annuler le traitement.

Vous pouvez choisir d’utiliser soit le flux de polling, soit le flux de webhook pour récupérer les résultats.

Polling - interrogez le serveur jusqu’à ce que les résultats soient prêts. Lorsque vous utilisez un SDK, les requêtes de polling sont gérées pour vous en un seul appel de méthode. Mieux adapté aux tests et aux faibles volumes.&#x20;

[Webhooks](/v2/fr/integrations/webhooks.md) - envoyez les résultats directement à votre serveur. Lorsque vous utilisez un SDK, la désérialisation de la réponse est gérée pour vous ; il vous suffit de transmettre le corps brut de la requête. Mieux adapté aux utilisations intensives en production.

## Développement et tests

Un processus de développement classique nécessitera des tests avant le déploiement en production, afin de s’assurer qu’un modèle donné fonctionne correctement avec une version de code spécifique.

Les modèles Mindee ne sont pas versionnés ; ils peuvent plutôt être verrouillés et/ou copiés selon les besoins. Cela offre davantage de flexibilité dans la manière dont vous organisez et gérez vos modèles, afin de mieux correspondre à votre processus de développement.

Votre cycle de publication de développement pourrait ressembler à ceci :

1. Commencez avec un nouveau modèle. Si vous apportez des ajustements à un modèle de production existant, copiez-le et n’apportez des modifications qu’à la copie.\
   Pensez à ajouter des informations de version dans le nom du modèle copié, par exemple « Facture v1.1 » ou « Reçu 2026-05-17 ».
2. Ajustez votre code selon les besoins et testez.
3. Lors du déploiement de votre code dans des environnements de test ou de production, utilisez l’identifiant 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`

## Foire aux questions

<details>

<summary><strong>Puis-je utiliser les mêmes clés API V1 dans la V2 ?</strong></summary>

Non, V1 et V2 ne partagent pas les informations de clé API.

</details>

<details>

<summary><strong>Puis-je exécuter V1 et V2 en parallèle ?</strong></summary>

Oui, tout à fait.

L’exécution des deux plateformes en parallèle est non seulement prise en charge, mais recommandée si vous migrez de V1 vers V2.

Tous les SDK ont une prise en charge complète de l’exécution de V1 et V2 en parallèle ; plus d’informations ici : [Bibliothèques clientes / SDK](/v2/fr/integrations/client-libraries-sdk.md)

</details>

<details>

<summary><strong>Fournissez-vous un environnement de test ou de préproduction ?</strong></summary>

Nous ne fournissons pas d’environnements distincts pour le développement, la préproduction, la production, etc.

Pour obtenir des informations sur les tests de vos modèles et de votre code avant le déploiement en production, consultez : [#developing-and-testing](#developing-and-testing "mention")

</details>

<details>

<summary><strong>Comment puis-je exporter les résultats au format CSV ?</strong></summary>

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 comporte que des lignes et des colonnes.

Pour convertir le format objet de Mindee en format CSV, vous pouvez soit supprimer des informations, soit générer plusieurs fichiers CSV (ou feuilles).

Chaque modèle étant différent, et chaque cas d’utilisation étant 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 le [SDK](/v2/fr/modeles-extraction/sdk-integration.md) pour manipuler facilement les objets, ou définir des règles de mappage dans votre [no-code](/v2/fr/modeles-extraction/no-code-integration.md) solution.

</details>


---

# 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/api-overview.md?ask=<question>&goal=<user_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.