Saltar al contenido principal
POST
Verificar atestación
Verifique el estado actual de un registro y la evidencia disponible. Para verificar su firma criptográfica, envíe la carga útil original firmada exacta como payload_b64url. Un ID de registro o una huella digital de archivo por sí solos no pueden proporcionar esos bytes.

Elija la verificación que necesita

Una verificación solo por ID o solo por huella digital devuelve INCOMPLETE y signature_verified: false a menos que se aplique un resultado más fuerte como REVOKED, EXPIRED o ALTERED. Suministre la carga útil original para una verificación de firma completa. Un attestation en línea debe identificar un registro registrado con attestation_id. El estado en línea y la identidad de la clave se cargan de ese registro; los campos proporcionados por el llamador no pueden anular su emisor o revocación. Utilice un verificador fuera de línea compatible para comprobaciones de firma independientes.

Interpretar la respuesta

signature_verified informa específicamente la verificación de la firma. log.proof_checked informa la verificación exitosa de la inclusión de transparencia. Una prueba faltante produce una razón y un índice de hoja nulo; cero es una primera hoja legítima. Un valor expires_at_unix ausente no significa que se deba inventar una nueva fecha de vencimiento para un registro histórico.
Una firma válida no prueba la propiedad, la validez legal o la veracidad de cada afirmación. Lea reasons, la gobernanza actual del emisor y la evidencia disponible antes de confiar en un registro. Las políticas opcionales o las verificaciones de registro pueden no estar disponibles incluso cuando la firma de la carga útil pasa.

Autenticación y límites

La verificación pública no requiere una clave API. Las llamadas autenticadas utilizan el espacio de trabajo y el entorno del llamante y pueden estar sujetas a su asignación de verificación. Los límites de velocidad del servicio aún se aplican a las solicitudes públicas. Un registro privado o de sandbox puede no estar disponible a través de una búsqueda de producción anónima. Comparta un registro accesible usando https://verify.truthlocks.com/proof/{attestation_id}. Una URL compartida no otorga acceso a cargas útiles privadas.

Autorizaciones

X-API-Key
string
header
requerido

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

Cuerpo

application/json
attestation
object | null

Sobre de búsqueda en línea. Se requiere un attestation_id registrado aquí o a nivel de solicitud. El estado almacenado, el emisor, la clave y la hora de emisión son autoritativos; las copias suministradas no pueden anularlos.

attestation_id
string
document_hash_hex
string
payload_b64url
string

Respuesta

200 - application/json

Resultado de la verificación

Evidencia de verificación pública. Inspeccione las razones y las comprobaciones individuales; una comprobación solo de ID no verifica el contenido original proporcionado por el llamante.

verdict
enum<string>
requerido

Inspeccione las razones, las entradas de verificación proporcionadas y log.proof_checked junto con este veredicto. VÁLIDO por sí solo no establece la propiedad ni prueba todas las afirmaciones en el registro.

Opciones disponibles:
VALID,
INCOMPLETE,
INVALID,
REVOKED,
ALTERED,
SUPERSEDED,
EXPIRED,
UNKNOWN_ISSUER,
NOT_FOUND
signature_verified
boolean

Verdadero solo cuando la carga útil original suministrada pasó la verificación de firma criptográfica. Las comprobaciones solo por ID y solo por huella digital devuelven falso.

reasons
string[]
attestation_id
string<uuid>
issuer_id
string<uuid>
expires_at_unix
integer<int64> | null

Caducidad firmada registrada en segundos Unix; nulo significa que no se registra ninguna caducidad. A los registros heredados no se les asigna una nueva caducidad.

issued_at_unix
integer<int64>

Tiempo de emisión original almacenado en segundos Unix. Este no es el momento de la verificación actual o la descarga del certificado. Ausente si no está disponible.

kid
string

Identificador de clave de firma.

alg
string

Algoritmo de firma declarado.

payload_hash
string

Resumen SHA-256 codificado en Base64url de la carga útil canónica.

document_hash
string

Huella digital hexadecimal SHA-256 del archivo original, cuando se almacena.

log
object
governance
object