Passer au contenu principal
Un scénario typique de traitement de documents à l’aide d’appels d’API séparés (pour créer une transaction, charger un fichier et démarrer une transaction) comprend les étapes suivantes :
  1. Réception d’une liste de toutes les Skills disponibles
  2. Création d’une transaction vide
  3. Ajout d’un ensemble de fichiers à traiter dans la transaction
  4. Démarrage de la transaction
  5. Suivi de l’état de la transaction
  6. Téléchargement des fichiers source et des fichiers de résultat
Chaque requête envoyée au serveur doit inclure des informations d’authentification (par exemple un jeton d’accès). Pour plus d’informations, consultez Authentication.

​
Récupérer la liste de toutes les Skills disponibles

Pour ce faire, envoyez une requête GET à la ressource skills : Exécutez la commande suivante : En conséquence, vous recevrez des informations sur toutes les compétences ajoutées à l’instance d’application.

​
Création d’une transaction vide

Pour cela, envoyez la requête POST suivante à la ressource transactions : Exécutez la commande suivante : Dans le corps de la requête, spécifiez le Parameter skillId renvoyé par l’appel d’API précédent. Vous recevrez alors une réponse contenant l’id de la transaction créée.

​
Ajout d’un ensemble de fichiers à traiter dans la transaction

Important ! Le nombre maximal de fichiers dans une transaction est de 1 000. Un ensemble de fichiers peut être ajouté de deux manières :

​
Ajout de fichiers directement à la transaction

Pour ce faire, envoyez une requête POST vers la ressource transactions/<transaction-id>/files : Exécutez la commande suivante : En conséquence, vous recevrez une réponse contenant la liste des fichiers ajoutés et leurs identifiants. Vous pouvez ajouter autant de fichiers que nécessaire en répétant cet appel autant de fois que nécessaire. Options supplémentaires pour le chargement des fichiers :

​
Ajout de fichiers à un document

Commencez par créer un document en envoyant une requête POST à la ressource transactions/<transaction-id>/documents : Vous recevrez alors une réponse contenant l’identifiant du document. Ajoutez ensuite des fichiers au document en envoyant une requête POST à la ressource transactions/<transaction-id>/documents/<document-id>/sourceFiles :

​
Démarrer la transaction

Pour démarrer la transaction avec la compétence et les fichiers spécifiés, envoyez la requête POST suivante à la ressource transactions/<transaction-id>/start :

​
Suivi de l’état de la transaction

Pour commencer à surveiller l’état de la transaction à l’aide d’une boucle avec un court délai d’attente (nous ne recommandons pas de vérifier l’état plus d’une fois par seconde), envoyez une requête GET à la ressource transactions/&lt;transaction_id&gt; en incluant l’identifiant de la transaction dans l’URI de la requête : En conséquence, vous recevrez une réponse contenant l’état de la transaction. Le traitement de la transaction peut être dans l’un des états suivants :
  • New. La transaction a été créée mais n’a pas encore été placée dans la file d’attente de traitement.
  • Queued. La transaction est en file d’attente pour le traitement.
  • InProgress. La transaction est en cours de traitement.
  • Processed. La transaction a été traitée avec succès.
  • ProcessedWithWarnings. La transaction a été traitée, mais des avertissements sont survenus.
  • NotProcessed. La transaction n’a pas été traitée en raison d’une erreur.
  • Deleted . La transaction a été supprimée par l’utilisateur ou automatiquement selon la stratégie de conservation.
Si l’état de la transaction est Processed ou ProcessedWithWarnings, passez à l’étape 6.

​
Téléchargement des fichiers source

Pour obtenir la liste des documents avec leurs identifiants, envoyez une requête GET à la ressource transactions/<transaction-id>/documents et indiquez l’identifiant de la transaction : Par conséquent, vous recevrez la liste de tous les documents créés dans cette transaction. La réponse contient également les identifiants de ces documents, qui peuvent être nécessaires pour obtenir des informations détaillées sur des documents spécifiques. Pour obtenir la liste des fichiers ajoutés à un document donné, envoyez une requête GET à la ressource transactions/<transaction-id>/documents/<document-id> : En conséquence, vous recevrez des informations sur le document. La réponse contient également les identifiants des fichiers ajoutés au document. Pour télécharger le fichier source, envoyez une requête GET à la ressource transactions/<transaction-id>/files/<file-id>/download :