Guide

Modèles

Préparez un document une fois, puis envoyez-le à d'autres personnes en un seul appel.

Créez un modèle dans l'application

Les modèles se créent dans l'application : téléversez le document, ajoutez des rôles comme Client, et placez les champs de chaque rôle. Obtenez-en la liste avec GET /templates; chaque modèle indique ses rôles.

Envoyer à partir d'un modèle

Passez template_id et attribuez chaque rôle à une personne. Les champs viennent du modèle : vous n'en placez aucun.

bash

curl -X POST "https://api.esorasign.com/v1/documents" \
  -H "Authorization: Bearer $ESORA_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "template_id": "tpl_2zg4mZaouqKLiMcVbpT4r5",
    "recipients": [
      { "template_role": "Client", "name": "Maya Chen", "email": "maya.chen@example.com" },
      { "template_role": "Account manager", "name": "John Smith", "email": "john.smith@example.com" }
    ],
    "send": true
  }'

Chaque rôle doit être rempli avant l'envoi (sinon 422 not_ready). Pour envoyer un modèle à beaucoup de gens à partir d'un tableur, utilisez l'envoi en masse dans l'application.