Intégrez la signature dans votre propre produit.

L'API eSignSimple est-elle disponible ?

Votre propre logiciel peut désormais créer des documents, les envoyer pour signature, suivre leur statut et télécharger les copies signées sans que personne ne se connecte à un tableau de bord. L'API REST se trouve à l'adresse https://esignsimple.com/api/v1, et la référence complète, avec des exemples de requêtes et de réponses, figure sur notre page développeurs.

Les signataires touchés via l'API bénéficient exactement de la même expérience de signature sans compte et des mêmes preuves que pour les documents envoyés depuis le tableau de bord : une piste d'audit, un certificat de signature et une empreinte SHA-256 que chacun peut contrôler sur notre page de vérification publique.

Comment fonctionne l'API ?

Créez un document avec POST /documents. Vous envoyez une requête multipart contenant le PDF et une partie JSON listant les signataires et les champs, dont les positions sont exprimées en fractions de la page : inutile de vous soucier des points PDF ou des formats de page. Le document est envoyé immédiatement, ou conservé en brouillon si vous passez send:false.

Vous avez déjà un modèle dans le tableau de bord ? POST /templates/{id}/send renseigne les signataires et l'envoie. GET /documents liste vos documents avec un filtre de statut et une pagination par curseur via before. GET /documents/{id} renvoie le statut, les signataires et la piste d'audit complète, et GET /documents/{id}/download renvoie le PDF signé une fois le document finalisé, ou l'original avec ?file=original.

Vous pouvez aussi annuler un document en cours avec POST /documents/{id}/void, en supprimer un avec DELETE /documents/{id}, et consulter votre offre et votre consommation actuelle avec GET /me.

Comment fonctionnent l'authentification et les clés API ?

Chaque requête utilise une clé API de type Bearer. Vous créez et révoquez vos clés dans Paramètres → Développeurs. Une clé n'est affichée qu'une fois, à sa création, et nous n'en conservons qu'un hachage : copiez-la donc tout de suite dans votre gestionnaire de secrets. Si une clé fuite, révoquez-la et créez-en une nouvelle ; rien d'autre n'a besoin de changer.

La même API accepte aussi les jetons d'identification Firebase, que notre future application mobile utilisera. C'est un choix délibéré : nous construisons nos propres applications sur la même API publique que vous, si bien qu'elle est mise à l'épreuve tous les jours.

Quels webhooks pouvez-vous recevoir ?

Plutôt que d'interroger l'API en boucle, enregistrez un point de terminaison HTTPS pour votre compte et nous le notifierons dès qu'il se passe quelque chose. Les événements sont document.completed, document.declined, document.voided et signer.signed.

Chaque envoi est signé en HMAC-SHA256 et la signature est transmise dans l'en-tête esign-signature, pour que vous puissiez confirmer que la requête vient bien de nous avant d'agir. Si votre point de terminaison échoue, nous réessayons une fois. Notre conseil : considérez les webhooks comme un déclencheur et appelez GET /documents/{id} pour obtenir l'état qui fait foi.

Que construit-on avec l'API ?

Un CRM ou un outil de devis qui envoie un contrat dès qu'une affaire est marquée comme gagnée. Un SIRH qui envoie un dossier d'intégration à partir d'un modèle quand une embauche est confirmée. Un outil de gestion locative qui envoie un bail et classe le PDF signé dans la fiche du logement à l'arrivée de document.completed. Un script interne qui évite à quelqu'un de recopier à la main des lignes de tableur dans des contrats.

Si vous envoyez une poignée de documents par semaine, vous n'avez probablement pas besoin de l'API. Les modèles, l'envoi groupé et les formulaires web du tableau de bord vous suffiront, avec bien moins d'efforts.

Combien coûte l'API ?

Il n'existe pas d'offre API séparée. Les mêmes limites s'appliquent que dans l'application web : l'offre gratuite inclut 5 documents par mois et l'offre Personnel est illimitée (voir les tarifs). Les documents créés via l'API sont décomptés exactement comme ceux envoyés depuis le tableau de bord.

Les grands fournisseurs comme DocuSign, Dropbox Sign et Adobe facturent généralement leurs API à part des offres utilisateurs, souvent selon des volumes annuels d'enveloppes, et leurs offres API d'entrée de gamme peuvent coûter nettement plus cher que leurs abonnements standard. Consultez leurs sites pour les tarifs en vigueur.

Qu'est-ce qui n'est pas encore inclus ?

Nous sommes honnêtes sur ce qui manque. Il n'y a pas encore d'iframe de signature intégrée : les signataires signent toujours via le lien que nous leur envoyons par e-mail. Il n'y a pas de SDK officiels ; l'API repose sur du HTTP et du JSON standard, donc tout langage doté d'un client HTTP fonctionne. Il n'y a pas d'environnement sandbox séparé : testez avec un compte gratuit et vos propres adresses e-mail. Tous ces éléments figurent sur notre feuille de route.

Pourquoi avons-nous commencé par une petite API ?

Nous avons volontairement commencé petit. Une API restreinte qui gère bien le flux le plus courant, avec des limites prévisibles et sans rendez-vous commercial, est plus utile qu'une surface immense qui demande des semaines d'intégration. S'il vous manque quelque chose, dites-nous ce que vous construisez : ce sont les intégrations réelles qui décident de nos prochains ajouts.

Quels points de terminaison de l'API existent aujourd'hui ?