Création d’expériences de signature électronique et de document intégrées
Découvrez comment utiliser les API Acrobat Sign pour intégrer des expériences de signature électronique et de document dans vos plateformes web et systèmes de gestion de contenu et de document. Ce tutoriel pratique se divise en quatre parties.
Partie 1 : Ce dont vous avez besoin
Dans la partie 1, découvrez comment prendre en main tout ce dont vous avez besoin pour les parties 2 à 4. Commençons par obtenir les identifiants d’API.
-
Python 3.x
- Mac — Homebrew
- Linux : programme d'installation intégré
- Windows — Chocolatey
- Tous — https://www.python.org/downloads/
Partie 2 : Code faible/nul — la puissance des formulaires web
Dans la deuxième partie, explorez l’option de codage faible/sans code de l’utilisation des formulaires web. Il est toujours bon de voir si vous pouvez éviter d’écrire du code au début.
-
Accédez à Acrobat Sign avec votre compte développeur.
-
Sélectionnez Publish un formulaire web sur la page d’accueil.
-
Créez votre accord.
-
Incorporer votre accord sur une page de HTML plat.
-
Testez l’ajout dynamique de paramètres de requête.
Partie 3 : Envoi d’un accord avec un formulaire et fusion des données
Dans la partie 3, créez des accords de manière dynamique.
Tout d’abord, vous devez établir l’accès. Avec Acrobat Sign, il existe deux façons de se connecter via une API. Jetons et clés d’intégration OAuth. À moins d’avoir une raison très spécifique d’utiliser OAuth avec votre application, vous devez d’abord explorer les clés d’intégration.
-
Sélectionnez Clé d'intégration dans le menu Informations sur l'API sous l'onglet Compte dans Acrobat Sign.
Maintenant que vous avez accès à l’API et que vous pouvez interagir avec elle, découvrez ce que vous pouvez faire avec l’API.
-
Accédez aux méthodes de l’API REST Acrobat Sign version 6.
-
Utilisez le jeton comme valeur « porteur ».
Pour envoyer votre premier accord, il est préférable de comprendre comment utiliser l’API.
- Créer un document temporaire et l’envoyer.
note note |
---|
NOTE |
Les appels de requête JSON disposent d’une option « Modèle » et « Schéma de modèle minimal ». Vous obtenez ainsi des spécifications et une charge utile minimale. |
Après avoir envoyé un accord pour la première fois, vous pouvez ajouter la logique. Il est toujours bon d'établir des aides pour minimiser les répétitions. En voici quelques exemples :
Validation
En-têtes/Auth
URI de base
Sachez où les documents temporaires atterrissent dans le grand schéma de l’écosystème Sign.
Transitoire -> Accord
Temporaire -> Modèle -> Accord
Temporaire -> Widget -> Accord
Cet exemple utilise un modèle comme source du document. Il s’agit généralement du meilleur moyen, à moins que vous n’ayez une raison sérieuse de générer dynamiquement des documents pour signature (par exemple, un code hérité ou une génération de document).
Le code est assez simple : il utilise un document de bibliothèque (modèle) comme source du document. Les premier et deuxième signataires sont attribués dynamiquement. L'état IN_PROCESS
signifie que le document est envoyé immédiatement. En outre, mergeFieldInfo
est utilisé pour remplir les champs de manière dynamique.
Partie 4 : Intégration de l’expérience de signature, des redirections et plus encore
Dans de nombreux scénarios, vous pouvez autoriser le participant déclencheur à signer immédiatement un accord. Ceci est utile pour les applications et les kiosques orientés client.
Si vous ne souhaitez pas que le premier e-mail envoyé se déclenche, une façon simple de gérer le comportement consiste à modifier l’appel API.
Voici comment contrôler la redirection post-signature :
Après la mise à jour du processus de création de l’accord, l’étape finale consiste à générer l’URL de signature. Cet appel est également assez simple et génère une URL qu’un signataire peut utiliser pour accéder à sa partie du processus de signature.
note note |
---|
NOTE |
Notez que l’appel de création d’accord est techniquement asynchrone. Cela signifie qu’un appel d’accord « POST » peut être effectué, mais que l’accord n’est pas encore prêt. La meilleure pratique consiste à établir une boucle de nouvelle tentative. Utilisez une nouvelle tentative ou toute autre méthode adaptée à votre environnement. |
Lorsque tout est mis ensemble, la solution est assez simple. Vous créez un accord, puis générez une URL de signature sur laquelle le signataire peut cliquer pour commencer le rituel de signature.
Rubriques supplémentaires
-
Événements de webhook
-
Rappels personnalisés
-
Avec la création initiale
-
Ou ajoutez-en un en cours
-