Uma atestação é uma declaração assinada de um emissor. Uma integração útil gerencia todo o ciclo de vida: o que é assinado, como os destinatários o verificam, como a evidência é compartilhada e o que acontece quando a declaração não deve mais ser confiável.
Defina o registro antes de chamar a API
Escolha uma referência de negócios estável, o emissor responsável pela declaração e o payload mínimo necessário para o fluxo de trabalho. Use o esquema suportado e a codificação exata documentada para sua versão da API. Não improvise formatos de assinatura a partir de um certificado visual ou de um exemplo de código antigo.
Para um registro de conclusão de curso, os campos importantes podem incluir uma referência de curso e detalhes de conclusão aprovados. A instituição decide o que a declaração significa. Truthlocks assina e gerencia o registro dentro do fluxo de trabalho de emissão configurado.
Emita e retenha o resultado
Use a identidade de emissão correta e a chave de assinatura configurada. Armazene o identificador de registro retornado e a evidência que sua aplicação precisa para verificações posteriores. Lide com erros de validação, permissão e serviço explicitamente. Se uma solicitação de emissão expirar, determine se um registro foi criado antes de tentar novamente uma gravação.
Verifique o comportamento de idempotência real do endpoint e da versão do SDK que você usa. Um limite de novas tentativas por si só não estabelece que repetir uma gravação não pode criar eventos de negócios duplicados.
Verifique antes de apresentar uma conclusão
Verifique o registro suportado usando as informações de chave pública apropriadas. Mantenha a integridade da assinatura, o contexto do emissor e o status atual visíveis como partes separadas do resultado. Se a verificação não estiver disponível, diga isso e forneça ao usuário um caminho de nova tentativa ou revisão, em vez de exibir um selo de sucesso.
Compartilhar e gerenciar alterações
Um link de verificação oferece aos destinatários uma rota para a verificação atual. Um link suportado pacote de prova pode conter assinaturas, chaves e provas de log disponíveis para inspeção independente. Evidências offline não podem relatar uma revogação que ocorreu após a criação do pacote.
Defina quem pode revogar um registro e quando uma declaração corrigida exige uma nova emissão. Teste um registro revogado e um payload alterado antes de integrar o caminho de sucesso em sua interface de usuário.
Construa com base na documentação atual
Use o documentação atual da API e as assinaturas de método do seu SDK instalado. Comece com o exemplo de conclusão de curso ou fluxo de trabalho de registro de permissão, então adapte os campos e as responsabilidades de aprovação ao seu sistema.
