Saltar al contenido principal
POST
Verificar la verdad del documento
La implementación actual simula la extracción y la verificación de IA. Su veredicto y confianza generados no son evidencia de la autenticidad del documento. No utilice este endpoint para aprobar identidades, establecer el cumplimiento o autenticar documentos.
El manejador acepta agent_id y document_hash, con document_type, file_name y metadata opcionales. El agente debe existir y estar activo. No acepta bytes de documentos en document_b64, realiza OCR ni compara un archivo cargado con el hash proporcionado. El manejador crea su registro de forma sincrónica. Utilice el identificador de documento devuelto con Obtener documento. Los hashes de extracción generados describen contenido simulado, no bytes de archivo extraídos. Las firmas de recibo de la tubería actualmente contienen marcadores del sistema en lugar de firmas criptográficas. Para la verificación criptográfica de registros, utilice Verificar atestación con una atestación firmada real y la carga útil original o el hash del documento. Esto comprueba la integridad y el estado del registro, no si las afirmaciones fácticas del documento son verdaderas.

Autorizaciones

X-API-Key
string
header
requerido

Clave API para autenticación máquina a máquina

Cuerpo

application/json
agent_id
string<uuid>
requerido

Agente solicitante

document_hash
string
requerido

Hash SHA-256 del documento

document_type
string
file_name
string
metadata
any

Respuesta

Resultado de verificación de documento

verification_id
string<uuid>
document_id
string<uuid>
document_hash
string
status
enum<string>
Opciones disponibles:
pending,
verified,
failed
results
object[]
verifications
object[]
claims
object[]
created_at
string<date-time>