Pular para o conteúdo
AssinAPI

API de assinatura eletrônica

Assinatura eletrônica dentro do seu sistema, por API.

Envie um PDF, receba o link de assinatura e seja avisado por webhook quando o documento for concluído — com trilha de auditoria verificável. Feito para quem integra em código, low-code ou com agentes de IA.

curl -X POST /v1/signature-requests

201 Created · 312 ms

"status": "SENT", "signingUrl": "…/s/9xq4m"

webhook signer.signed → 200 OK

Uma chamada para enviar

POST /v1/signature-requests

bash
curl -X POST https://api.assinapi.com.br/v1/signature-requests \
  -H "Authorization: Bearer $ASSINAPI_SECRET_KEY" \
  -H "Content-Type: application/json" -H "Idempotency-Key: $(uuidgen)" \
  -d '{"title":"Contrato","document":{"filename":"c.pdf","contentBase64":"<base64 do PDF>"},
       "signer":{"name":"João","email":"joao@email.com","cpf":"529.982.247-25"}}'

# → 201 { 17: 18, 19: 20, 21: 22 }

O que vem pronto

API REST + documentos

Um POST /v1/signature-requests envia PDF e signatário de uma vez; o fluxo granular (envelopes, documentos, signatários) cobre casos com vários PDFs.

Sandbox gratuito

Chaves ask_test_…, OTP fixo 123456 e CPFs de teste. Nada consome franquia e nada tem validade.

Webhooks assinados

HMAC-SHA256 com proteção contra replay, retries com backoff e dead letter visível no dashboard.

Audit trail encadeado

Cada evento referencia o hash do anterior; manifesto de evidências assinado e carimbo do tempo RFC 3161.

Múltiplos signatários

Ordem de assinatura opcional, lembretes manuais e automáticos e posicionamento por texto âncora ou coordenadas.

Templates de fluxo

Nível de assinatura, autenticação, ordem e expiração salvos em um templateId — a chamada fica ainda menor.

Identificação do signatário

Só e-mail ou e-mail + código; nos planos pagos, também só WhatsApp ou e-mail + WhatsApp (link + código). Na avançada, CPF e data de nascimento; opcionalmente foto do documento e selfie.

Segurança

Segredos só como hash, CPF cifrado, isolamento por organização/projeto/ambiente e verificação pública do PDF.

Preço previsível

Free

Grátis

10 documentos/mês

Developer

R$ 50/mês

50 documentos/mês

Growth

R$ 156/mês

200 documentos/mês

Scale

R$ 408/mês

600 documentos/mês

Avulso

R$ 1,49/doc

Créditos pré-pagos, sem mensalidade

Enterprise: condições sob contrato. Detalhes e excedentes em Preços.

Perguntas frequentes

Perguntas técnicas.

A assinatura feita pela AssinAPI tem validade jurídica?

Sim. As assinaturas da AssinAPI têm validade jurídica como assinatura eletrônica simples ou avançada (Lei 14.063/2020, art. 4º). Entre particulares, a MP 2.200-2/2001 (art. 10, § 2º) admite a assinatura eletrônica sem ICP-Brasil quando aceita pelas partes, e o CPC (art. 784, § 4º) admite qualquer modalidade prevista em lei em títulos executivos eletrônicos. Não usamos ICP-Brasil: atos com exigência legal específica (alguns atos com órgãos públicos e certos atos imobiliários, por exemplo) podem exigir outra modalidade, como a qualificada.

Como funciona a cobrança?

Você paga por documento enviado em Produção (franquia mensal do plano ou créditos avulsos). Requisições à API e o Sandbox não são cobrados.

Simples ou avançada: qual a diferença na autenticação?

Simples (aceites e documentos do dia a dia): por padrão só o link enviado por e-mail, sem código. Avançada (contratos): CPF e data de nascimento conferidos e código de confirmação; nos planos pagos, por padrão link por e-mail + código pelo WhatsApp oficial; no Free, link e código por e-mail (WhatsApp só nos planos pagos). Você pode trocar por documento (authenticationMethod) ou definir o padrão de cada projeto.

Sandbox e Produção usam endereços diferentes?

Não. O mesmo host atende os dois; o ambiente é definido pela chave (ask_test_… ou ask_live_…).

Como sei que o documento não foi alterado?

O PDF final traz relatório de auditoria e QR de verificação; qualquer pessoa pode conferir o arquivo em /verify, que recalcula os hashes.

Assinaturas SIMPLE e ADVANCED têm validade jurídica como assinatura eletrônica simples e avançada (Lei 14.063/2020, art. 4º; MP 2.200-2/2001, art. 10, § 2º), sem ICP-Brasil. Atos com exigência legal específica podem exigir a assinatura qualificada, que ainda não está disponível.

Primeira assinatura no Sandbox em menos de 10 minutos.

Sem cartão de crédito. Sandbox gratuito; você só paga por documentos enviados em Produção.