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 estruturadaschema 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 comattestation_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 campoproof_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.
