Ciclo de Vida do Certificado

Cada certificado no DokStamp possui um campo status que determina quais as ações que podem ser realizadas e como aparece ao público. As transições de estado são geridas internamente pela plataforma.

Valores de estado

Estado	Descrição
`draft`	Certificado em preparação. Ainda não verificável publicamente.
`issued`	Certificado emitido oficialmente. O URL de verificação está ativo.
`revoked`	Certificado revogado após a emissão. O URL de verificação apresenta um aviso de revogação.
`expired`	Certificado ultrapassou a data de validade (se uma foi definida).

Transições de estado

[draft] ──── finish: true ────► [issued]
                                    │
                                    ▼
                               [revoked]

[issued] ──► [expired]   (automático, baseado no período de validade)

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

Emitir um certificado

Para fazer a transição de um certificado de draft para issued, passe finish: true ao criá-lo. Isto desencadeia o fluxo de emissão completo: assinatura do ficheiro, geração do historial académico e notificação do estudante.

curl -X POST https://api.dokstamp.com/certificates \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "X-Tenant: {TENANT}" \
  -d '{
    "institution_uuid": "...",
    "course_uuid": "...",
    "student_uuid": "...",
    "file_uuid": "...",
    "finish": true
  }'

Omitir finish (ou passar false) cria o certificado como draft, permitindo revisão antes da publicação oficial.

Revogar um certificado

Chame PUT /certificates/{uuid}/revoke com um motivo opcional:

curl -X PUT https://api.dokstamp.com/certificates/{uuid}/revoke \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "X-Tenant: {TENANT}" \
  -d '{ "revocation_reason": "Issued in error — student did not complete requirements." }'

Após a revogação, o URL de verificação pública permanece acessível, mas apresenta 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 se encontra no estado issued, o campo public_verification_url é preenchido:

{
  "uuid": "a1b2c3d4-...",
  "status": "issued",
  "public_verification_url": "https://verificar.dokstamp.eu/a1b2c3d4"
}

Este URL pode ser partilhado com empregadores, outras instituições ou incluído no certificado impresso como QR code. Não é necessária autenticação para aceder ao mesmo.

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 juntamente com o 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 registado num ledger público num momento específico no tempo.

Primeiros Passos

Conceitos Fundamentais

Autenticação

Instituições

Organizações

Cursos

Módulos

Estudantes

Matrículas

Certificados

Modelos de Certificado

Ficheiros

Guias

Guia de Integração

Ciclo de Vida do Certificado

Ciclo de Vida do Certificado

Valores de estado

Transições de estado

Emitir um certificado

Revogar um certificado

Verificação pública

Snapshot do Sujeito da Credencial

Ancoragem em blockchain

​Ciclo de Vida do Certificado

​Valores de estado

​Transições de estado

​Emitir um certificado

​Revogar um certificado

​Verificação pública

​Snapshot do Sujeito da Credencial

​Ancoragem em blockchain

Ciclo de Vida do Certificado

Valores de estado

Transições de estado

Emitir um certificado

Revogar um certificado

Verificação pública

Snapshot do Sujeito da Credencial

Ancoragem em blockchain