API de assinatura eletrônica com envelopes e webhooks

curl -X POST "https://convertaja.com.br/v1/esign/envelopes" \
  -H "Authorization: Bearer $CONVERTAJA_KEY" \
  -F "file=@contrato.pdf" \
  -F 'data={"name":"Contrato de prestação de serviços","message":"Olá! Segue o contrato para assinatura.","signers":[{"name":"Ana Souza","email":"ana@cliente.com.br","role":"sign"},{"name":"Bruno Lima","email":"bruno@empresa.com.br","role":"witness"}],"fields":[{"signer":0,"type":"signature","page":0,"x":0.1,"y":0.75,"w":0.3,"h":0.07},{"signer":1,"type":"signature","page":0,"x":0.55,"y":0.75,"w":0.3,"h":0.07}],"webhook_url":"https://seusite.com.br/webhooks/convertaja"}'

import { openAsBlob } from 'node:fs';

const form = new FormData();
form.append('file', await openAsBlob('contrato.pdf'), 'contrato.pdf');
form.append('data', JSON.stringify({
  "name": "Contrato de prestação de serviços",
  "message": "Olá! Segue o contrato para assinatura.",
  "signers": [
    {
      "name": "Ana Souza",
      "email": "ana@cliente.com.br",
      "role": "sign"
    },
    {
      "name": "Bruno Lima",
      "email": "bruno@empresa.com.br",
      "role": "witness"
    }
  ],
  "fields": [
    {
      "signer": 0,
      "type": "signature",
      "page": 0,
      "x": 0.1,
      "y": 0.75,
      "w": 0.3,
      "h": 0.07
    },
    {
      "signer": 1,
      "type": "signature",
      "page": 0,
      "x": 0.55,
      "y": 0.75,
      "w": 0.3,
      "h": 0.07
    }
  ],
  "webhook_url": "https://seusite.com.br/webhooks/convertaja"
}));

const res = await fetch('https://convertaja.com.br/v1/esign/envelopes', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.CONVERTAJA_KEY}` },
  body: form,
});
const envelope = await res.json();
console.log(envelope.id, envelope.status); // ex.: K7QD-9WZ2-M4HT-R8PA pending

import json, os, requests

dados = {
    "name": "Contrato de prestação de serviços",
    "message": "Olá! Segue o contrato para assinatura.",
    "signers": [
        {
            "name": "Ana Souza",
            "email": "ana@cliente.com.br",
            "role": "sign"
        },
        {
            "name": "Bruno Lima",
            "email": "bruno@empresa.com.br",
            "role": "witness"
        }
    ],
    "fields": [
        {
            "signer": 0,
            "type": "signature",
            "page": 0,
            "x": 0.1,
            "y": 0.75,
            "w": 0.3,
            "h": 0.07
        },
        {
            "signer": 1,
            "type": "signature",
            "page": 0,
            "x": 0.55,
            "y": 0.75,
            "w": 0.3,
            "h": 0.07
        }
    ],
    "webhook_url": "https://seusite.com.br/webhooks/convertaja"
}
res = requests.post(
    "https://convertaja.com.br/v1/esign/envelopes",
    headers={"Authorization": f"Bearer {os.environ['CONVERTAJA_KEY']}"},
    files={"file": open("contrato.pdf", "rb")},
    data={"data": json.dumps(dados)},
)
envelope = res.json()
print(envelope["id"], envelope["status"])

<?php
$dados = json_decode('{"name":"Contrato de prestação de serviços","message":"Olá! Segue o contrato para assinatura.","signers":[{"name":"Ana Souza","email":"ana@cliente.com.br","role":"sign"},{"name":"Bruno Lima","email":"bruno@empresa.com.br","role":"witness"}],"fields":[{"signer":0,"type":"signature","page":0,"x":0.1,"y":0.75,"w":0.3,"h":0.07},{"signer":1,"type":"signature","page":0,"x":0.55,"y":0.75,"w":0.3,"h":0.07}],"webhook_url":"https://seusite.com.br/webhooks/convertaja"}', true);
$ch = curl_init('https://convertaja.com.br/v1/esign/envelopes');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('CONVERTAJA_KEY')],
  CURLOPT_POSTFIELDS => ['file' => new CURLFile('contrato.pdf'), 'data' => json_encode($dados)],
]);
$envelope = json_decode(curl_exec($ch), true);
echo $envelope['id'];