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 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'utilisation différents autour du traitement de documents. Ceux-ci peuvent servir à 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é, voir la Aperçu des modèles section pour plus de détails. Il peut s'agir de n'importe quel type de modèle (modèle d'extraction ou modèle utilitaire), tous les modèles s'intègrent de manière très similaire.

Nous recommandons d'utiliser le Live test fonctionnalité avant de tenter d'intégrer l'API.

Vous aurez également besoin d'au moins une clé API, voir la Gérer les clés API 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 soit un flux de polling, soit un flux 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 le moyen le plus rapide et le plus simple d'appeler nos API, et cela permet à nos équipes de support 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 section.

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 :

Langages/frameworks 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 suivi des anomalies ou directement sur GitHub.

No-code ou low-code

Si vous intégrez à l'aide d'une plateforme no-code ou low-code, jetez un coup d'œil à la Intégration no-code section.

Intégration manuelle

Si aucune des options ci-dessus ne répond à vos besoins, jetez un coup d'œil à la Intégration manuelle section.

Nous ne recommandons pas d'intégrer manuellement, et ne pouvons pas garantir une prise en charge complète.

Les offres Pro et supérieures bénéficient d'une assistance à l'intégration étendue.

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 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 effectuer un POST du fichier 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 - utilise une route GET et convient mieux aux tests et aux faibles volumes.

Utilisation des webhooks - envoie directement à votre serveur et convient mieux à une utilisation intensive en production.

Développement et tests

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 de le copier et de n'apporter des modifications qu'à la copie. Pensez à ajouter des informations de version au nom du modèle copié, par exemple « Factures v1.1 » ou « Reçus 2026-05-17 ».
2. Ajustez votre code selon les besoins et testez-le.
3. Lors du déploiement de 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 afin d'éviter des modifications accidentelles.
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 est non seulement prise en charge, mais également recommandée si vous migrez de V1 vers V2.

Tous les SDK prennent pleinement en charge l'exécution simultanée de V1 et V2, plus d'informations ici : Bibliothèques clientes / SDK

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 les tests de vos modèles et de votre code avant le déploiement en production, jetez un coup d'œil à : Aperçu de l’intégration

Comment puis-je exporter les résultats vers 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 les répartir dans plusieurs fichiers CSV (ou feuilles).

Comme chaque modèle est différent et que chaque cas d'utilisation est différent, il n'existe pas de méthode universelle pour effectuer cette conversion.

C'est à vous d'établir un mappage qui corresponde à vos besoins. Vous pouvez utiliser les SDK pour manipuler facilement les objets, ou mettre en place des règles de mappage dans votre no-code solution.