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.

StyleAPI REST, JSON et multipart
Adressehttps://api.solu-sign.com/api/v1
AuthentificationClé d'API, en-tête Bearer
Limite de débit100 requêtes / minute / organisation
NotificationsWebhooks signés HMAC-SHA256
Réessais5 tentatives automatiques

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 sequential pour signer l'un après l'autre, parallel pour signer en même temps.
  • signatureLevel vaut simple ou eidas_aes pour 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.