> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Especificação de registro assinado

> Como construir, reter e verificar uma atestação sem confundir reivindicações com resultados de verificação.

Revisão: 2026-10-13.

## O payload assinado

A emissão aceita `schema` e `claims` estruturados, ou `payload_b64url` contendo os bytes exatos a serem assinados. Não forneça ambas as formas. Preserve o payload, a resposta e a chave de idempotência. Um payload codificado não é criptografia.

O registro inclui seu identificador, emissor, tempo de emissão, resumo da carga útil, algoritmo de assinatura declarado, identificador de chave, assinatura e referências de transparência. Escolha uma chave que esteja ativa, disponível para assinatura e suporte o algoritmo solicitado. O registro de chave pública por si só não torna uma chave de assinatura privada disponível.

## Expiração

Para entrada estruturada, o `expires_at_unix` opcional é um carimbo de data/hora Unix inteiro em segundos. Ele se torna parte do payload JSON assinado. Para entrada codificada, coloque este campo na raiz do payload JSON antes de codificá-lo; não envie um campo de expiração não assinado separado.

A data deve ser posterior à emissão. A verificação retorna `EXPIRED` após esse instante. A expiração armazenada não pode ser estendida ou removida no local; emita uma substituição. Omitir a expiração não inventa uma vida útil padrão. Registros históricos sem uma expiração armazenada não recebem uma retrospectivamente. Datas dentro de reivindicações, como `claims.expiry_date`, não definem automaticamente a expiração da atestação.

## Risco do emissor e reivindicações

O snapshot de governança registra a classificação do emissor na emissão. Uma classificação de risco do emissor não é uma pontuação de risco automatizada para o conteúdo do documento. `unknown` significa que nenhuma avaliação foi registrada. Novas aprovações de equipe exigem uma avaliação com suporte de evidências; elas não reescrevem snapshots antigos.

## Referências de transparência

`log.leaf_index` é baseado em zero: zero pode ser a primeira entrada real. Uma referência ausente ou indisponível é distinta de zero. `log.leaf_hash` identifica a folha registrada. Esses campos sozinhos não estabelecem verificação de inclusão bem-sucedida; verifique a prova e o ponto de verificação em relação a uma chave confiável.

## Verificação e exportação

Forneça o payload original para verificar a integridade do payload e sua assinatura. Leia o veredito e os motivos juntos: `INCOMPLETE` com `signature_verified: false` e `payload_not_provided` significa que a verificação de payload-assinatura não foi realizada. Uma comparação de hash de arquivo verifica a impressão digital fornecida em relação à impressão digital armazenada; isso não prova a propriedade ou a veracidade do conteúdo do arquivo.

Certificados privados do Console exigem acesso ao espaço de trabalho. Um download de certificado não publica um registro. A verificação pública está sujeita ao registro e ao ambiente disponíveis para o verificador público.

Use [Mint Attestation](https://docs.truthlocks.com/pt/api-reference/attestations/mint.md), [verificação](https://docs.truthlocks.com/pt/api-reference/verify.md) e o [quickstart](https://docs.truthlocks.com/pt/quickstart.md) para formatos de solicitação. Mantenha uma solicitação inalterada ao tentar novamente uma cunhagem; alterar campos assinados sob a mesma chave de idempotência é um conflito.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.