Documentação técnica Aceitou¶

API REST para integrar assinatura eletrônica com validade jurídica na sua aplicação.

O que você consegue fazer¶

Criar e enviar documentos pra assinatura — PDF ou gerado a partir de template com variáveis
Múltiplos signatários com ordem de assinatura paralela ou sequencial
Verificação por OTP via email/SMS quando precisa elevar garantia
Webhooks com HMAC pra reagir a eventos (document_sent, signer_signed, document_completed)
Validade jurídica ICP-Brasil quando configurado (em roadmap)

Em 4 chamadas você manda um documento pra assinar¶

# 1. Criar
curl -X POST https://api.aceitou.com.br/api/v1/documents \
  -H "X-Api-Key: $KEY" -H "Content-Type: application/json" \
  -d '{"title": "Contrato de prestação de serviços"}'

# 2. Anexar PDF
curl -X POST https://api.aceitou.com.br/api/v1/documents/123/documents \
  -H "X-Api-Key: $KEY" -F "file=@contrato.pdf"

# 3. Adicionar signatário
curl -X POST https://api.aceitou.com.br/api/v1/documents/123/signers \
  -H "X-Api-Key: $KEY" -H "Content-Type: application/json" \
  -d '{"name":"Maria","email":"maria@cliente.com","verificationMethod":"email_token","signingOrder":1}'

# 4. Enviar
curl -X POST https://api.aceitou.com.br/api/v1/documents/123/send \
  -H "X-Api-Key: $KEY"

Pronto. A Maria recebe email, assina, e seu webhook é notificado em cada etapa.

Próximos passos¶

Início rápido — fluxo completo passo a passo
Autenticação — como sua chave funciona
Webhooks — validar assinatura, eventos disponíveis
Códigos de erro — tabela de troubleshooting

Ambientes¶

	URL base
Sandbox / Demo	`https://api-demo.aceitou.com.br`
Produção	`https://api.aceitou.com.br`

A mesma chave não funciona em ambos — peça ao seu cliente Aceitou uma chave separada de sandbox.