Comment commencer avec le service de conversion en utilisant Postman
Postman est un outil de téléchargement gratuit pour faire des requêtes HTTP. Il peut être utilisé pour tester et faire connaissance avec n'importe quelle API REST comme celle offerte par le service de conversion 4-Heights®️.
Configurer le système
Téléchargez et installez le service de conversion 4-Heights®️.
Télécharger: Essai de 30 jours
Instructions plus détaillées : Manuelle
Téléchargez et installez Postman.
Importer la collection de demandes à Postman
Télécharger la collection : Collection de Postman
Ouvrez Postman et cliquez sur Importation.
Faites glisser la collection téléchargée pour importer la fenêtre.
Cliquez sur Service de conversion 4-Heights®️ dans la vue Collections.
Essayez-le
Tout d'abord, assurez-vous que le baseURL dans les variables de votre collection spécifie l'hôte où votre service de conversion 4 hauteurs®️ s'exécute.
Jetez un œil aux demandes disponibles : Référence API
Pour vous familiariser avec Postman, essayez une simple demande : lister les workflows disponibles.
Ceci est utile pour obtenir un aperçu des flux de travail disponibles.
Le nom d'un workflow peut alors être utilisé comme paramètre d'entrée lors de la création d'une nouvelle tâche.
Traiter votre premier fichier (pour plus d'informations sur la séquence de traitement de la tâche, veuillez vous référer à la section "Utilisation de l'API" dans la Manuelle)
Créer un nouveau job avec un flux de travail de votre choix.
Le travail est créé et prêt pour les données.
L'identifiant de la tâche nouvellement créée est sauvegardé dans la variable collection ID de tâche et utilisé automatiquement pour les requêtes subséquentes.
Obtenir les infos sur le poste pour vérifier qu'une tâche a été réellement créée.
La réponse devrait vous dire que le statut du poste est "créé".
Ajouter des données à la tâche (choisir le fichier dans Corps tab).
Vous pouvez répéter cette étape plusieurs fois avec différents fichiers afin d'ajouter plus de données à votre travail.
Commencer la tâche
Le service de conversion commencera à traiter tous les documents que vous avez ajoutés à la tâche.
Obtenir les infos sur le poste à nouveau.
La réponse devrait maintenant vous dire que le statut de la tâche est "terminé" (ou "traitement" si vous avez ajouté des fichiers volumineux et qu'il n'est pas encore terminé).
Obtenir le résultat du job pour recevoir des informations sur le résultat
L'id du premier jeu de données de résultat est stocké dans la variable collection resultId et utilisé automatiquement dans la requête suivante.
Si votre flux de travail retourne plus d'un jeu de données, copiez tous les identifiants.
Récupérer les données du résultat du job pour recevoir le document généré par le service de conversion.
Enregistrez la réponse en tant que fichier PDF pour la voir (cliquez sur Enregistrer la réponse, puis Enregistrer dans un fichier sur le côté droit).
Supprimer le job pour libérer toutes les ressources utilisées pour le traiter.
Toutes les variables de collection associées à la tâche sont réinitialisées.
Summary
La numérisation a radicalement modifié les processus de courrier entrant. Le temps de traitement et de réponse peut être réduit de manière significative malgré l'énorme augmentation des formes et des formats possibles qui se trouvent dans la boîte de réception.