AssinAPI

PDF assinado e auditoria

Ao concluir, a AssinAPI gera um PDF final por documento e o envia anexado por e-mail a todos os signatários.

Conteúdo

  • As páginas originais, com os carimbos nas posições definidas e um rodapé com o código de verificação.
  • Relatório de assinaturas e auditoria, anexado ao final: dados do documento (SHA-256 do original), e para cada signatário — assinatura visual, e-mail, CPF mascarado, método de autenticação, data/hora de autenticação e assinatura, IP completo, localização aproximada do IP (cidade/UF/país, pela base IP Geolocation by DB-IP, consultada no próprio servidor — o IP não é enviado a terceiros), localização GPS (se autorizada), dispositivo e navegador, verificação de identidade e hash da assinatura.
  • Trilha de auditoria com horário (Brasília e UTC) e IP de cada evento: envio, acesso, visualização, código, fotos, assinatura, aprovação, conclusão.
  • QR code para a verificação pública.

Como baixar

  • GET /v1/signature-requests/{id}/download ou GET /v1/envelopes/{id}/download — arquivo PDF, sem expiração (exige a API key).
  • GET /v1/signature-requests/{id} → downloads.signedPdfUrl — link temporário que abre sem chave (bom para no-code).
  • ?type=certificate — certificado de evidências (manifesto assinado, carimbo do tempo, cadeia de auditoria).

Localização por IP

A localização vem de um provedor GeoIP configurado no servidor (GEOIP_DRIVER = ipapi (padrão), ipinfo, ipwhois ou none; chave em GEOIP_TOKEN). É aproximada (cidade do provedor de internet) e nunca bloqueia a assinatura: se o provedor falhar, o relatório indica “não disponível”. IPs de rede privada aparecem como “rede privada/local”.

Integridade

A assinatura visual, a localização e os hashes das fotos entram no hash de cada assinatura, que é ancorado no manifesto assinado pelo servidor. Qualquer alteração posterior no banco resulta em INVALID_EVIDENCE na verificação.