Saltar para o conteúdo principal

​
Revogar um Certificado

A revogação marca permanentemente um certificado como inválido. A revogação fica visível na URL de verificação pública, incluindo o motivo e o timestamp.
A revogação é irreversível. Um certificado revogado não pode ser reintegrado. Se um certificado foi revogado por engano, é necessário emitir um novo.

​
Revogar

PUT /certificates/{uuid}/revoke
ParâmetroTipoObrigatórioDescrição
revocation_reasonstringNãoExplicação legível para a revogação
curl -X PUT "https://api.dokstamp.eu/certificates/a1b2c3d4-e5f6-7890-abcd-ef1234567890/revoke" \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "X-Tenant: {TENANT}" \
  -d '{
    "revocation_reason": "Emitido por engano — o estudante não concluiu todos os módulos obrigatórios."
  }'
Resposta 200: 
{
  "data": {
    "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "revoked",
    "revoked_at": "2025-03-01T10:30:00.000000Z",
    "revocation_reason": "Emitido por engano — o estudante não concluiu todos os módulos obrigatórios.",
    "public_verification_url": "https://verificar.dokstamp.eu/a1b2c3d4"
  }
}

​
O que acontece após a revogação

  • status muda para revoked
  • revoked_at é definido com o timestamp atual
  • A public_verification_url permanece acessível e apresenta um aviso de revogação
  • O certificado é removido das contagens e relatórios de certificados ativos
  • O ficheiro PDF original permanece no armazenamento

​
Motivos comuns de revogação

  • Estudante não satisfez os requisitos de graduação
  • Certificado emitido com dados incorretos do estudante
  • Fraude académica descoberta após a emissão
  • Erro administrativo durante a emissão em lote

​
Relacionados