Saltar para o conteúdo principal
POST
Verificar Verdade do Documento
A implementação atual simula extração e verificação por IA. Seu veredito e confiança gerados não são evidência de autenticidade do documento. Não use este endpoint para aprovar identidades, estabelecer conformidade ou autenticar documentos.
O manipulador aceita agent_id e document_hash, com document_type, file_name e metadata opcionais. O agente deve existir e estar ativo. Ele não aceita bytes de documento em document_b64, realiza OCR ou compara um arquivo carregado com o hash fornecido. O manipulador cria seu registro de forma síncrona. Use o identificador de documento retornado com Obter Documento. Hashes de extração gerados descrevem conteúdo simulado, não bytes de arquivo extraídos. As assinaturas de recibo do pipeline atualmente contêm marcadores de sistema em vez de assinaturas criptográficas. Para verificação criptográfica de registos, use Verificar Atestado com um atestado assinado real e o payload original ou hash do documento. Isso verifica a integridade e o estado do registo, não se as afirmações factuais do documento são verdadeiras.

Autorizações

X-API-Key
string
header
obrigatório

Chave de API para autenticação máquina a máquina

Corpo

application/json
agent_id
string<uuid>
obrigatório

Agente solicitante

document_hash
string
obrigatório

Hash SHA-256 do documento

document_type
string
file_name
string
metadata
any

Resposta

Resultado da verificação do documento

verification_id
string<uuid>
document_id
string<uuid>
document_hash
string
status
enum<string>
Opções disponíveis:
pending,
verified,
failed
results
object[]
verifications
object[]
claims
object[]
created_at
string<date-time>