Assinatura eletrônica por API, com validade jurídica.

Como funciona

Quatro passos até a primeira assinatura.

1. 1

   Crie a conta grátis

   Nome, e-mail e senha. Confirme o e-mail e entre no painel; quem programa com IA tem a documentação em /llms.txt.

2. 2

   Gere a chave de Sandbox

   A chave ask_test_… aparece uma vez: copie e guarde no servidor (variável de ambiente). No Sandbox o código de verificação é sempre 123456.

3. 3

   Faça a primeira chamada

   POST /v1/signature-requests com o PDF e o signatário, mais um Idempotency-Key. A resposta 201 traz o signingUrl para assinar.

4. 4

   Receba o webhook e as evidências

   envelope.completed chega assinado com HMAC. No painel ficam a trilha de auditoria e o PDF final, com verificação pública.

import { AssinAPI } from '@assinapi/sdk';

const assinapi = new AssinAPI({ apiKey: process.env.ASSINAPI_SECRET_KEY });

const request = await assinapi.signatureRequests.create({
  title: 'Contrato de prestação de serviços',
  file: pdfBuffer,
  filename: 'contrato.pdf',
  signer: { name: 'João da Silva', email: 'joao@email.com', cpf: '529.982.247-25' },
});

console.log(request.signingUrl); // link para o signatário

const event = assinapi.webhooks.constructEvent({
  payload: rawBody,            // corpo BRUTO da requisição
  headers: req.headers,
  secret: process.env.ASSINAPI_WEBHOOK_SECRET!,
});

if (event.type === 'envelope.completed') {
  // documento assinado por todos: libere o pedido, baixe o PDF final…
}

O que já vem pronto

A parte difícil, resolvida.

• Sandbox gratuito

  Chaves ask_test_…, código fixo 123456 e CPFs de teste. Documentos do Sandbox não consomem franquia.

• Webhooks confiáveis

  Assinatura HMAC-SHA256 com proteção contra replay, novas tentativas com backoff e fila de falhas (dead letter) visível no painel.

• Trilha de auditoria

  Cada evento referencia o hash do anterior. Manifesto de evidências assinado e verificação pública do PDF em /verify.

• Idempotência

  Header Idempotency-Key nos POSTs: repetir a chamada não duplica envio. O SDK gera e reutiliza a chave nos retries.

• SDK oficial Node/TS

  npm install @assinapi/sdk. Erros com code, hint, link da documentação e requestId.

• CLI para desenvolvimento

  Receba webhooks do Sandbox no localhost, dispare eventos de teste e confira um PDF pelo terminal.