Documentação
A API que assina, prova e guarda
O AEDOC nasceu como API: tudo que o painel faz, a sua integração também faz. Comece pelo guia, consulte o contrato completo na referência — e, se você automatiza com IA, aponte o agente para o llms.txt.
Guia de integração
Do zero ao primeiro documento assinado: chave de API, envelope, signatário, envio, webhooks e verificação HMAC.
Para quem está começando
Referência da API
Todas as rotas, schemas, parâmetros e códigos de erro, gerados do contrato OpenAPI que governa a implementação.
Para consulta no dia a dia
Para agentes de IA
Índice legível por máquina no padrão llms.txt, apontando para a spec OpenAPI crua e para as regras que o seu agente precisa respeitar.
Para Claude, Cursor e afins
O essencial em um minuto
- Base URL
- https://api.aedoc.com.br
- Autenticação
Authorization: Bearer aedoc_live_…— chaves com escopos mínimos, criadas no painel.- Convenções
- Rotas sob
/v1, corpos em JSON, ids em ULID, datas ISO 8601 em UTC. - Ciclo de vida
- draft → ready → sent → viewed → partially_signed → processing → signed (mais declined, expired, cancelled, failed)
A spec crua está em /openapi.yaml — é a fonte da verdade do contrato, e o que você deve dar ao seu gerador de cliente.
Enquadramento jurídico
O AEDOC implementa assinatura eletrônica avançada (Lei 14.063/2020, art. 4º, II): hash SHA-256 do documento, trilha de auditoria imutável e verificação de identidade do signatário.
Não é assinatura qualificada PAdES/ICP-Brasil — essa é uma fase futura, explícita. Não descreva de outra forma na sua aplicação.
A verificação pública de integridade responde sempre íntegro (hash confere) | alterado | expirado | não encontrado — nunca “válido”. Reflita essa linguagem na sua UI.
Dúvida que a documentação não resolve? Fale com a gente.