Saltar para o conteúdo

Exclui um certificado que não vale mais

DELETE/api/certificates/{id}

Auth
Exige token
Quem pode:
owner
admin
X-CommunityId
X-CommunityId Envie o X-CommunityId da comunidade em que a operação acontece.

Owner ou admin. Só certificado **revogado** (inclusive o substituído por uma reemissão, `replacedById` preenchido) ou **com falha**. Válido (`ISSUED`): 409 "revogue antes de excluir"; ainda gerando (`PENDING`): 409. Apaga os arquivos (PDF, imagem da página e cards) e a linha, de vez: a verificação do código passa a responder 404, igual a um código que nunca existiu. A exclusão fica registrada no log (quem, qual código, quando).

Parâmetros

NomeOndeTipoDescrição
idobrigatóriopathstring (uuid)

Headers

NomeTipoDescrição
X-CommunityIdopcionalstring (uuid)ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade.

Respostas

CódigoDescrição
200Excluído. `data` traz `id` e `code`.
401Token ausente, inválido ou expirado.
403Autenticado, mas sem permissão para esta operação.
404Recurso não encontrado.
409Certificado válido ou ainda gerando.
500Erro interno do servidor.

Exemplo com curl

curl -X DELETE "https://api.memberfy.net/api/certificates/<id>" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID"