Passer au contenu principal
La plateforme ABBYY Vantage fournit deux API REST pour intégrer le traitement intelligent de documents dans vos applications :

API de traitement

Soumettre des documents, gérer les transactions et récupérer les données extraites

API de reporting

Accéder aux données d’analyses et de rapports métier

​
URL de base

Toutes les requêtes API sont effectuées vers le serveur de production Vantage : 
https://vantage-us.abbyy.com

​
Authentification

L’API Vantage utilise OAuth 2.0 pour l’authentification. Chaque requête doit inclure un jeton d’accès dans l’en-tête Authorization : 
Authorization: Bearer {your_access_token}
Vantage prend en charge trois flux d’authentification :
FluxIdéal pour
Resource Owner Password CredentialsIntégrations serveur à serveur
Authorization Code FlowApplications destinées aux utilisateurs
Client CredentialsCommunication machine à machine
Contactez ABBYY pour demander la création d’un tenant dans ABBYY Vantage. Une fois que vous disposez d’un compte de tenant, vous pouvez créer des comptes utilisateur et des clients d’API pour l’authentification.

​
API de traitement

L’API de traitement (/api/publicapi/v1/) vous permet de :
  • Créer des transactions — Soumettre des documents pour traitement avec un Skill spécifique
  • Gérer les fichiers — Téléverser, modifier et organiser des images de documents
  • Suivre l’état — Surveiller l’avancement des transactions et gérer les erreurs
  • Récupérer les résultats — Télécharger les données extraites au format JSON ou XML
  • Gérer les catalogues — Utiliser des catalogues de données et des tables de recherche

​
Workflows courants

Traitez des documents avec une seule requête qui gère automatiquement le chargement, le traitement et la récupération des résultats.En savoir plus →
Utilisez des appels d’API distincts pour un contrôle précis du chargement des documents, de leur traitement et de la récupération des résultats.En savoir plus →
Intégrez la relecture manuelle à votre workflow pour les documents nécessitant une vérification humaine.En savoir plus →

​
API de reporting

L’API de reporting (/api/reporting/v2/) permet d’accéder à :
  • Indicateurs métier — Volumes de transactions, temps de traitement et débit
  • Analyses de qualité — Précision d’extraction et scores de confiance
  • Données détaillées par champ — Résultats d’extraction détaillés pour l’analyse
En savoir plus sur le reporting →

​
Formats de sortie

Vantage retourne les données extraites dans des formats structurés :

Sortie JSON

Données hiérarchiques avec l’ensemble des détails d’extraction et les scores de confiance

Sortie XML

Balisage structuré pour les systèmes qui requièrent une intégration XML

​
Ressources pour les développeurs

Guide du développeur

Guide complet pour l’intégration avec l’API Vantage

Collection Postman

Collection d’API prête à l’emploi pour les tests et l’exploration

​
Limitations de débit et bonnes pratiques

  • Opérations par lot — Utilisez les endpoints de traitement par lot lors du traitement de plusieurs enregistrements (jusqu’à 5 000 enregistrements de catalogue par requête)
  • Polling — Lors de la vérification de l’état d’une transaction, utilisez des intervalles raisonnables (5 à 10 secondes)
  • Gestion des erreurs — Mettez en œuvre une logique de nouvelle tentative avec temporisation exponentielle (exponential backoff) pour les erreurs transitoires

​
Prochaines étapes

1

Configurer l’authentification

Configurez OAuth 2.0 pour votre application
2

Traiter votre premier document

Suivez le guide de traitement pour soumettre un document
3

Explorer les API

Parcourez la documentation de référence complète de l’API Processing et de l’API Reporting