Faites signer depuis vos logiciels, en un seul appel.
L'API REST de Solusign permet à votre ERP, votre CRM ou votre logiciel métier d'envoyer un document à signer sans passer par la console. Les webhooks vous préviennent dès qu'il est signé.
Une API pensée pour les intégrations existantes
Beaucoup de logiciels métier savent produire un PDF et connaissent l'adresse du destinataire, mais n'ont pas été conçus pour enchaîner plusieurs appels. L'API Solusign leur propose un appel « tout-en-un » : un seul envoi suffit à créer l'enveloppe, déposer le document, poser les champs et l'envoyer.
L'API et les webhooks sont inclus dans toutes les offres, sans supplément. Chaque envoi consomme une enveloppe, comme depuis la console. Voir les tarifs.
Authentification par clé d'API
Vous créez une clé d'API dans la console. Elle se transmet dans l'en-tête Authorization: Bearer <clé> de chaque
requête. Toutes les enveloppes créées avec cette clé appartiennent à votre
organisation.
Une clé se révoque à tout moment depuis la console. Créez une clé par intégration : vous pourrez en couper une sans toucher aux autres.
Limite de débit
L'API accepte 100 requêtes par minute et par organisation. C'est largement suffisant pour des envois au fil de l'eau. Pour un envoi en masse, étalez vos requêtes et prévoyez une nouvelle tentative différée si la limite est atteinte.
Pour des volumes importants, l'offre Enterprise ajuste le volume d'enveloppes à vos besoins. Parlons-en.
L'appel tout-en-un, en pratique.
Une requête multipart avec trois parties : le contrat (nom, modèle, ordre de signature), les signataires (nom, email, niveau) et le PDF.
# Créer, préparer et envoyer une enveloppe en un appel
API=https://api.solu-sign.com/api/v1
curl -X POST "$API/public/envelopes/allinone" \
-H "Authorization: Bearer $SOLUSIGN_API_KEY" \
-F 'contract={
"name": "Contrat de prestation",
"fieldTemplate": "Contrat de prestation",
"mode": "sequential"
};type=application/json' \
-F 'recipients=[
{ "name": "Marie Lefèvre",
"email": "marie@exemple.fr",
"signatureLevel": "eidas_aes" }
];type=application/json' \
-F 'file=@contrat.pdf;type=application/pdf'
- fieldTemplate désigne le modèle à appliquer, par son nom : les champs sont posés sans que votre logiciel ait à connaître leurs coordonnées.
-
mode vaut
sequentialpour signer l'un après l'autre,parallelpour signer en même temps. -
signatureLevel vaut
simpleoueidas_aespour une signature avancée avec code de vérification. Voir les niveaux de signature. - Si votre solde d'enveloppes est vide, l'appel est refusé et rien n'est envoyé : aucun dépassement n'est facturé.
Marie Lefèvre et l'adresse marie@exemple.fr sont des exemples fictifs.
Webhooks : soyez prévenu, ne demandez pas.
Plutôt que d'interroger l'API en boucle, recevez un appel sur votre serveur à chaque étape importante.
Signés HMAC
Chaque notification porte l'en-tête X-Solusign-Signature: sha256=…,
calculé sur le corps brut avec votre secret. Recalculez-le pour vous assurer que
l'appel vient bien de Solusign.
Réessais automatiques
Si votre serveur ne répond pas ou répond en erreur, Solusign réessaie cinq fois : après 1 seconde, 10 secondes, 1 minute, 10 minutes puis 1 heure.
Cinq événements
Envoi, fin et annulation de l'enveloppe, signature et refus d'un signataire : de quoi mettre à jour votre logiciel sans intervention.
Les événements disponibles
| Événement | Déclenché quand | Usage typique |
|---|---|---|
envelope.sent |
L'enveloppe est envoyée aux signataires | Passer le dossier au statut « en signature » |
recipient.signed |
Un signataire a signé | Suivre l'avancement signataire par signataire |
recipient.declined |
Un signataire refuse de signer | Alerter le commercial ou le gestionnaire |
envelope.completed |
Tous les signataires ont signé | Valider la commande, déclencher la suite du processus |
envelope.voided |
L'enveloppe est annulée | Clore le dossier côté logiciel métier |
Cas d'usage
Solusign ne fournit pas de connecteur prêt à l'emploi pour un CRM ou un outil d'automatisation du marché : l'intégration passe par l'API, développée par votre équipe ou votre éditeur.
ERP et achats
Le bon de commande validé dans l'ERP part en signature chez le fournisseur.
L'événement envelope.completed met la commande à jour.
CRM et ventes
Le devis généré depuis la fiche client est envoyé au client en un appel. La signature fait avancer l'opportunité sans ressaisie.
Logiciel métier
Logiciel RH, de gestion locative ou d'officine : tout outil qui produit un PDF peut le faire signer en désignant un modèle.
Sécuriser votre intégration
Les échanges avec l'API sont chiffrés en transit (TLS). Le reste dépend aussi de votre côté : quelques règles simples évitent la plupart des incidents.
Pour les questions d'hébergement, de comptes et de RGPD, consultez la page sécurité.
- Gardez la clé d'API côté serveur, jamais dans une page web ou une application cliente
- Stockez-la dans un coffre à secrets, pas dans le code source
- Une clé par intégration, révoquée dès qu'elle n'est plus utilisée
- Vérifiez la signature HMAC de chaque webhook avant de le traiter
- Traitez chaque événement de façon idempotente : un réessai peut le livrer deux fois
- Répondez vite au webhook et traitez l'événement en différé si besoin
L'API est-elle payante ?
Non. Elle est incluse dans toutes les offres, y compris pendant l'essai. Seules les enveloppes envoyées sont décomptées.
Puis-je tester l'API pendant l'essai gratuit ?
Oui. Créez votre compte, générez une clé dans la console et envoyez-vous un document. Les 5 enveloppes offertes servent aussi bien depuis la console que depuis l'API.
Les signataires reçoivent-ils le même parcours que depuis la console ?
Oui. Ils reçoivent un email avec leur lien, saisissent leur code si leur signature est avancée, et reçoivent à la fin le PDF scellé et le dossier de preuve.
Existe-t-il une intégration Salesforce, HubSpot ou Zapier ?
Non, pas de connecteur prêt à l'emploi aujourd'hui. Si votre outil sait émettre des requêtes HTTP, il peut appeler l'API REST de Solusign : l'intégration est alors à développer de votre côté.
Branchez Solusign à vos outils
5 enveloppes offertes, sans carte bancaire, API comprise.