Saltar para o conteúdo principal
POST
Verificar Atestado
Verifique o status atual de um registro e as evidências disponíveis. Para verificar sua assinatura criptográfica, envie o payload assinado original exato como payload_b64url. Um ID de registro ou impressão digital de arquivo sozinho não pode fornecer esses bytes.

Escolha a verificação que você precisa

Uma verificação somente por ID ou somente por impressão digital retorna INCOMPLETE e signature_verified: false, a menos que um resultado mais forte, como REVOKED, EXPIRED ou ALTERED, se aplique. Forneça o payload original para uma verificação de assinatura completa. Um attestation inline deve identificar um registo registado com attestation_id. O status online e a identidade da chave são carregados desse registo; os campos fornecidos pelo chamador não podem substituir o seu emissor ou revogação. Use um verificador offline compatível para verificações de assinatura autónomas.

Interpretar a resposta

signature_verified relata especificamente a verificação da assinatura. log.proof_checked relata a verificação bem-sucedida da inclusão de transparência. Uma prova ausente produz uma razão e um índice de folha nulo; zero é uma primeira folha legítima. Um valor expires_at_unix ausente não significa que uma nova expiração deva ser inventada para um registro histórico.
Uma assinatura válida não prova propriedade, validade legal ou a verdade de cada reivindicação. Leia reasons, a governança atual do emissor e as evidências disponíveis antes de confiar em um registro. As verificações opcionais de política ou log podem não estar disponíveis mesmo quando a assinatura da carga útil é aprovada.

Autenticação e limites

A verificação pública não requer uma chave de API. Chamadas autenticadas usam o espaço de trabalho e o ambiente do chamador e podem estar sujeitas à sua permissão de verificação. Os limites de taxa de serviço ainda se aplicam a solicitações públicas. Um registro privado ou de sandbox pode não estar disponível por meio de uma pesquisa de produção anônima. Compartilhe um registro acessível usando https://verify.truthlocks.com/proof/{attestation_id}. Uma URL compartilhada não concede acesso a cargas úteis privadas.

Autorizações

X-API-Key
string
header
obrigatório

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

Corpo

application/json
attestation
object | null

Envelope de pesquisa online. Um attestation_id registado é necessário aqui ou ao nível do pedido. O estado armazenado, o emissor, a chave e a hora de emissão são autoritativos; as cópias fornecidas não podem substituí-los.

attestation_id
string
document_hash_hex
string
payload_b64url
string

Resposta

200 - application/json

Resultado da verificação

Evidência de verificação pública. Inspecione os motivos e as verificações individuais; uma verificação apenas de ID não verifica o conteúdo original fornecido pelo chamador.

verdict
enum<string>
obrigatório

Inspecione as razões, as entradas de verificação fornecidas e log.proof_checked junto com este veredito. VALID por si só não estabelece propriedade nem prova todas as alegações no registro.

Opções disponíveis:
VALID,
INCOMPLETE,
INVALID,
REVOKED,
ALTERED,
SUPERSEDED,
EXPIRED,
UNKNOWN_ISSUER,
NOT_FOUND
signature_verified
boolean

Verdadeiro apenas quando o payload original fornecido passou na verificação criptográfica de assinatura. Verificações somente de ID e somente de impressão digital retornam falso.

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

Expiração assinada registrada em segundos Unix; nulo significa que nenhuma expiração é registrada. Registros legados não recebem uma nova expiração.

issued_at_unix
integer<int64>

Tempo de emissão original armazenado em segundos Unix. Este não é o tempo da verificação atual ou do download do certificado. Ausente se indisponível.

kid
string

Identificador da chave de assinatura.

alg
string

Algoritmo de assinatura declarado.

payload_hash
string

Resumo SHA-256 codificado em Base64url da carga útil canônica.

document_hash
string

Impressão digital hexadecimal SHA-256 do arquivo original, quando armazenado.

log
object
governance
object