Skip to main content

Ciclo de Vida do Certificado

Todo certificado no DokStamp possui um campo status que governa quais ações podem ser realizadas nele e como ele aparece ao público. As transições de status são gerenciadas internamente pela plataforma.

Valores de status


Transições de estado

As transições de estado são irreversíveis. Um certificado revogado não pode ser reativado. Se um certificado foi revogado por engano, você deve emitir um novo.

Emitindo um certificado

Para fazer a transição de um certificado de draft para issued, passe finish: true ao criá-lo. Isso aciona o pipeline completo de emissão: assinatura do arquivo, geração do histórico acadêmico e notificação do estudante.
Omitir finish (ou passar false) cria o certificado como draft, permitindo revisão antes da publicação oficial.

Revogando um certificado

Chame PUT /certificates/{uuid}/revoke com um motivo opcional:
Após a revogação, a URL de verificação pública permanece acessível, mas exibe um aviso claro de revogação com o motivo e o timestamp. → Referência completa de revogação

Verificação pública

Quando um certificado está no status issued, o campo public_verification_url é preenchido:
Esta URL pode ser compartilhada com empregadores, outras instituições ou incluída no certificado impresso como QR code. Não é necessária autenticação para acessá-la.

Snapshot do Sujeito da Credencial

No momento em que um certificado é emitido, o DokStamp captura um snapshot dos dados de identidade do estudante (nome, email, documento de identificação, data de nascimento, país). Esse snapshot é armazenado de forma imutável junto ao certificado, de modo que a credencial permaneça verificável mesmo que o perfil do estudante seja atualizado posteriormente.

Ancoragem em blockchain

Os certificados incluem campos opcionais blockchain_tx_hash e blockchain_tx_url para ancoragem em blockchain. Quando definidos, fornecem uma prova resistente a adulterações de que o certificado foi registrado em um ledger público em um momento específico no tempo.