Come compongo e mando in firma con una chiamata?

Senza codice (1.4): nella console, Flussi, Fai firmare un documento Word prende un .docx già compilato, i firmatari, l'ordine, gli osservatori, la scadenza e i promemoria; Valida mostra i controlli e il costo, Invia esegue questo stesso flusso. Un tag {{ signature.A }} nel file Word posiziona una firma; senza tag ogni firmatario firma in fondo all'ultima pagina.

Usa /api/v1/flow invece di /api/v1/compose/documents/generate ogni volta che il documento va in firma nel momento stesso in cui esiste: una richiesta, un solo giro, e nessun momento in cui hai in mano un documento che non è ancora stato inviato:

curl -X POST https://your-host/api/v1/flow \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-4471" \
  -d '{
    "data": { "customer": { "name": "Acme Srl" } },
    "settings": { "templateId": "contract-standard-8bc99b" },
    "signature": {
      "subject": "Service agreement",
      "signers": {
        "A": { "email": "anna@acme.example", "fullName": "Anna Rossi",
               "fields": [{ "kind": "signature", "page": 1,
                            "x": 0.1, "y": 0.78, "width": 0.32, "height": 0.09 }] }
      }
    }
  }'

Dove va la firma. Il modo abituale è un tag nel modello, {{ signature.A }}, scritto come qualsiasi altro campo: il firmatario A allora non ha bisogno di fields e firma dove si trova il tag. L'alternativa è fields, come qui: x e y sono frazioni della pagina a partire dall'angolo in alto a sinistra (0.1 = un decimo della larghezza). Come leggerle da un PDF, e tutto il resto sul posizionamento di una firma: Dove va la firma sulla pagina.

La lingua dei firmatari. I messaggi e le pagine di firma usano la lingua di ciascun firmatario ("language": "it" o "en" nel firmatario), altrimenti quella della firma (signature.language), altrimenti quella della tua organizzazione.

Manda sempre l'Idempotency-Key: questa chiamata addebita due volte e scrive a una persona reale, e una richiesta ripetuta senza chiave rifà entrambe le cose. L'elenco completo dei campi e che cosa torna indietro: Componi e firma, con una chiamata.