Saltar para o conteúdo principal
Uma empresa primeiro cunha um atestado assinado e depois entrega uma referência a um consumidor. A entrega não cunha o atestado, verifica suas reivindicações ou torna registros privados públicos.

1. Cunhar

Siga o guia de início rápido usando o emissor e a chave de assinatura do espaço de trabalho da empresa. Forneça reivindicações de aplicação através de entrada estruturada schema e claims, ou codifique os bytes originais exatos como payload_b64url. Não combine ambos os modos. Mantenha o attestation_id retornado; não substitua um identificador att_ inventado onde a API requer um UUID.

2. Entregar

Use Entregar na caixa de entrada com attestation_id, o e-mail do destinatário em consumer_reference, e safe_metadata opcional. Use uma credencial de emissor para o espaço de trabalho que possui a atestação. HTTP 201 registra a entrega para uma caixa de entrada de consumidor existente. HTTP 202 com status: pending e reason: consumer_not_registered registra uma entrega pendente. Nenhuma das respostas prova que um e-mail chegou ao destinatário. Evite reivindicações sensíveis em metadados de exibição.

3. Ler a caixa de entrada

O consumidor autentica-se separadamente e usa Inbox. read_state aceita UNREAD, READ, ARCHIVED ou ALL. Uma chave de negócio não deve ser usada como identidade do consumidor. A entrega na caixa de entrada e a visibilidade do portfólio público são separadas. Não presuma que um item da caixa de entrada foi compartilhado publicamente apenas porque a entrega foi bem-sucedida.

4. Verificar

Use Verificar com o ID da atestação e, opcionalmente, o payload codificado original ou o hash do documento. Este endpoint não aceita um campo proof_bundle base64. Inspecione o veredito e as razões em vez de apenas o status HTTP. Para provas offline, siga a especificação do pacote de prova. A validação criptográfica offline precisa de chaves públicas confiáveis e não pode estabelecer o status de revogação atual sem informações de status recentes. Nem a verificação de assinatura online nem offline prova que a reivindicação subjacente do mundo real é verdadeira.