Aller au contenu

Glossaire · Mis à jour

API de signature électronique

Une API de signature électronique permet à un logiciel de créer, envoyer, suivre et télécharger des demandes de signature par programmation, sans passer par l'application web.

Que signifie « API de signature électronique » ?

Une API de signature électronique est une interface de programmation qui permet à votre propre logiciel d'envoyer des documents à signer, de suivre leur statut et de récupérer les fichiers signés, sans que personne ne clique dans l'application web du prestataire. En bref, c'est ainsi que les développeurs automatisent la signature et la connectent aux CRM, aux SIRH et aux produits sur mesure.

Une intégration type fonctionne ainsi : votre système s'authentifie avec une clé d'API, envoie une requête pour créer une demande de signature à partir d'un PDF ou d'un modèle, liste les signataires et leur ordre, et reçoit un identifiant en retour. Le prestataire envoie ensuite un e-mail aux signataires ou renvoie une URL pour la signature intégrée. Quand quelque chose change, comme une signature ou un refus, le prestataire appelle votre webhook, et votre système télécharge le document finalisé et sa piste d'audit.

Prenons une agence d'intérim qui place des intervenants chaque semaine. Au lieu qu'un recruteur importe chaque contrat à la main, le logiciel de recrutement appelle l'API dès qu'une mission est confirmée, remplit le modèle avec les informations de l'intervenant et range automatiquement la copie signée dans la fiche du candidat.

Idée reçue : une API serait réservée aux grandes entreprises. Les petites équipes qui ont un seul processus répétitif peuvent aussi en profiter, et les outils sans code peuvent souvent appeler une API à votre place. Autre idée reçue : les documents signés via API seraient juridiquement différents. Ce sont les mêmes signatures, avec la même piste d'audit, simplement déclenchées par du code.

L'API est la base de la signature intégrée et souvent de l'envoi groupé, et elle s'appuie généralement sur des modèles pour générer les documents de façon cohérente.

Pour évaluer une API de signature électronique, regardez les détails pratiques : une documentation claire, un bac à sable ou un mode test, des limites de débit raisonnables, des nouvelles tentatives pour les webhooks, et la possibilité de télécharger à la fois le PDF signé et la piste d'audit. Vérifiez comment les erreurs sont signalées et si l'API peut utiliser les mêmes modèles que ceux gérés par votre équipe dans l'application web. Ces détails décident si une intégration prend un jour ou un mois, et si elle continue de fonctionner sans bruit après le lancement.

Notre avis : si la signature est une étape d'un processus que votre logiciel exécute déjà, une API fait gagner de vraies heures et évite les erreurs de copier-coller. Si vous envoyez quelques contrats par semaine, l'application web est plus rapide à mettre en place et plus facile à maintenir.

L'API REST d'eSignSimple est disponible : authentification par clé d'API en Bearer, création et envoi de documents à partir d'un PDF ou d'un modèle, suivi du statut et de la piste d'audit, téléchargement du PDF signé, et webhooks quand les documents sont finalisés, refusés ou annulés. Les SDK, un bac à sable et la signature intégrée sont sur notre feuille de route. Chaque document finalisé comprend une piste d'audit, un certificat de signature et une empreinte SHA-256 vérifiable sur notre page publique. La référence complète se trouve dans notre documentation développeurs.

« API de signature électronique » : un exemple concret

Un petit éditeur SaaS veut que chaque nouveau client grand compte signe automatiquement un bon de commande. Quand une affaire passe en « gagnée » dans son CRM, un script appelle l'API REST d'eSignSimple avec une clé d'API, crée un document à partir du modèle de bon de commande avec les informations du client, et l'envoie. Un webhook prévient son système quand le document est finalisé, et le script télécharge le PDF signé dans la fiche client.

Quels sont les termes associés ?

  • Modèle: Un modèle de signature électronique est un document réutilisable avec des rôles de signataires et des champs prédéfinis, pour renvoyer le même contrat sans tout reparamétrer.
  • Envoi groupé: L'envoi groupé permet d'envoyer un document ou un modèle à de nombreux destinataires d'un coup, chacun recevant et signant son propre exemplaire.
  • Formulaire web (lien de signature): Un formulaire web, en signature électronique, est une page hébergée avec un lien public, qui permet à chacun de remplir et signer un document sans invitation préalable.
  • Signature intégrée: La signature intégrée permet de signer des documents directement dans votre site ou votre application, au lieu de suivre un lien e-mail vers le site du prestataire.

Questions fréquentes

Comment s'authentifier auprès de l'API eSignSimple ?

Créez une clé d'API dans les paramètres de votre compte et envoyez-la comme jeton Bearer dans l'en-tête Authorization de chaque requête. Les clés commencent par es_live_ et doivent rester secrètes comme un mot de passe : stockez-les dans des variables d'environnement, jamais dans du code côté client. Vous pouvez révoquer une clé à tout moment.

Que peut-on faire avec l'API eSignSimple ?

Vous pouvez créer des documents à partir d'un PDF ou d'un modèle, ajouter des signataires, les envoyer, suivre leur statut, lire la piste d'audit et télécharger le PDF signé final. Des webhooks préviennent votre serveur quand un document est finalisé, refusé ou annulé. Le détail des endpoints figure sur la page /developers.

eSignSimple propose-t-il des SDK ou un bac à sable ?

Pas encore. L'API REST fonctionne avec n'importe quel langage capable d'envoyer des requêtes HTTP, mais nous ne publions pas aujourd'hui de SDK officiels ni d'environnement de bac à sable séparé. Les deux sont sur notre feuille de route. Pour tester, beaucoup de développeurs envoient des documents à leurs propres adresses e-mail.

Faites signer votre prochain document dès aujourd'hui.

5 documents gratuits par mois pour commencer. Aucune carte bancaire requise.