Documento não sai de casa
Menos dados pessoais trafegando e menos exposição para contratos, prontuários e sigilo.
API de assinatura por hash
Assinatura digital ICP-Brasil sem enviar o seu PDF
Seu sistema calcula o hash SHA-256 e recebe de volta a assinatura CMS destacada, feita com o certificado A1, VIDaaS ou Bird ID do titular. O documento continua no seu servidor.
- Só o hash SHA-256 (32 bytes) trafega
- Retorno CMS/PKCS#7 destacado ou RAW (PKCS#1) com o certificado do titular
- A1, VIDaaS e Bird ID na mesma chamada
- Seu layout, seu carimbo e seu QR
Para quem já gera o próprio PDF
Rápido e leve
Sem upload nem download de arquivos grandes: a chamada carrega apenas o hash.
Seu motor de PDF
Você controla ByteRange, aparência e QR; a API só assina.
Certificados em nuvem
VIDaaS e Bird ID com autorização do titular, sem credenciamento direto com cada provedor.
Certificado A1
PFX e senha usados em memória no envio direto ou em sessão opcional cifrada.
ICP-Brasil
Assinatura qualificada (Lei 14.063/2020), política AD-RB.
Como funciona
- 1
Calcule o hash
Reserve /Contents no PDF e gere o SHA-256 do ByteRange.
- 2
Chame a API
Envie hash, provedor e CPF; o titular autoriza quando necessário.
- 3
Insira o CMS
Grave o cms_base64 retornado no /Contents do seu PDF.
Exemplo de chamada
Dados fictícios. Use sua API Key no servidor, nunca no navegador.
POST /api/public/v1/signatures/hash
X-API-Key: pk_exemplo_0000000000000000
X-API-Secret: sk_exemplo_0000000000000000
Content-Type: application/json
{
"provider": "vidaas",
"hash": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
"hash_algorithm": "SHA-256",
"document_name": "Contrato 2026-0142",
"signer": { "cpf": "52998224725" },
"external_id": "contrato-0142"
}
// Resposta
{
"status": "signed",
"cms_base64": "MIAGCSqGSIb3DQEHAqCAMIACAQExDzAN...",
"signed_at": "2026-11-09T19:40:00.000Z"
}Onde usar
Prontuários e sistemas de saúde
Receitas e laudos gerados pelo próprio software.
Software houses e ERPs
Assinatura dentro do seu fluxo, com seu layout.
Jurídico e cartorial
Documentos sob sigilo que não podem sair do ambiente.
Alto volume
Lotes grandes sem custo de banda com arquivos.
Perguntas frequentes
Como funciona a assinatura por hash?
Seu sistema prepara o PDF, reserva o espaço da assinatura, calcula o SHA-256 do intervalo assinado e envia só esse hash. A API devolve a assinatura CMS (PKCS#7) destacada, que seu sistema insere no PDF. Se preferir montar o próprio CMS, peça o formato RAW (PKCS#1) e receba também o certificado do titular.
Quais certificados são aceitos?
Certificado A1 (enviado na chamada ou em sessão opcional de até 7 dias) e certificados em nuvem VIDaaS e Bird ID, autorizados pelo titular.
O PDF é enviado para vocês?
Não. Nesse endpoint trafega apenas o hash de 32 bytes. Montar o PDF, o carimbo visual e o QR de conferência fica a cargo do seu sistema.
A assinatura gerada tem carimbo do tempo (AD-RT)?
Não no momento. A assinatura segue a política básica (AD-RB). O carimbo do tempo de uma ACT não está incluído.
Quando prefiro o endpoint de PDF completo?
Quando você quer que a plataforma gere o PAdES, o carimbo visual, o QR e a página de verificação. Para isso use a assinatura ICP-Brasil padrão.
Posso testar antes de contratar?
Sim. O cadastro de parceiro libera uma chave de teste de 30 dias.
- • Neste endpoint a plataforma não gera carimbo visual nem página de verificação; isso fica com o seu sistema.
- • Carimbo do tempo (AD-RT) não está incluído no momento.
Comece hoje, sem sandbox
Credenciais reais na hora, 30 dias de teste. Veja também: Assinatura ICP-Brasil com PDF completo — quando você prefere que a plataforma gere o PDF assinado, o carimbo e o QR.