Développement & intégration API

Envoyer un document PDF à Yousign

L'objectif de cet article est de présenter comment envoyer un fichier PDF à Yousign pour signature. 

Schéma

Int_grer_l_API_REST_Yousign_-_Step_01.png

Il conviendra de répéter cette étape autant de fois que vous avez de documents à faire signer.

Développement

A titre d'exemple, voici la configuration des Headers à mettre en place au sein de l'outil Postman pour s'authentifier à l'API :

Int_grer_l_API_REST_Yousign_-_Step_01_-_Postman.png

Rappel : Il est important d'ajouter le mot "Bearer" devant votre clé API.

 

Maintenant voici un exemple d'envoi de fichier :

Int_grer_l_API_REST_Yousign_-_Step_01_-_Postman_Body.png

Lors de cette étape, vous avez la possibilité de passer en paramètre un ID de procédure. Ceci est bien sur facultatif car, jusqu'à présent, nous n'avons pas encore créé de procédure de signature.

Vous avez également la possibilité de préciser le mot de passe de votre document PDF si celui-ci est protégé. Nous serons en mesure de signer votre document uniquement en connaissance du mot de passe associé.

Les metadatas seront présentés sous forme de clé / valeur. Vous pouvez donc tout à fait remplacer les clés "type" et "source" ainsi que les valeurs "Test" et "Yousign" par les informations que vous jugerez pertinentes.

 

Voici la réponse obtenue en retour :

Int_grer_l_API_REST_Yousign_-_Step_01_-_Postman_Response.png

Votre document est désormais envoyé chez Yousign.

Voyons maintenant comment inviter un signataire à signer ce document en créant une procédure de signature.

Cet article vous a-t-il été utile ?
Utilisateurs qui ont trouvé cela utile : 0 sur 0