Nunciatura Provista

API Documentation V1

Excluir Função Eclesiástica

Remove uma função eclesiástica do sistema

Este endpoint é do tipo: Protected

Descrição

Remove uma função eclesiástica do sistema com as seguintes funcionalidades:

  • Exclui permanentemente a função eclesiástica
  • Verifica se a função está sendo utilizada por usuários
  • Bloqueia exclusão se houver dependências
  • Requer autenticação JWT válida

Detalhes do Endpoint

VERBO

DELETE

URL BASE

http://api.provista.hmg.nabrasil.org.br/v1

ENDPOINT

/categories/{id}

Parâmetros da URL

Parâmetro Tipo Obrigatório Descrição
id integer Sim ID único da função eclesiástica

Cabeçalhos

Parâmetro Valor
Authorization Bearer <token>
Accept application/json

Respostas

Sucesso - 200

{
  "success": true,
  "message": "Função eclesiástica excluída com sucesso"
}

Nota: A exclusão é permanente e só é permitida se a função não estiver sendo utilizada por usuários.

Erro - 422 (Em uso)

{
  "success": false,
  "message": "Não é possível excluir esta função eclesiástica pois está sendo utilizada por usuários"
}

Erro - 404 (Não encontrado)

{
  "success": false,
  "message": "Função eclesiástica não encontrada"
}

Erro - 401 (Token inválido)

{
  "success": false,
  "message": "Token não fornecido"
}

Códigos de Resposta

Código Descrição
200 Função eclesiástica excluída com sucesso
401 Token inválido ou expirado
404 Função eclesiástica não encontrada
422 Função está sendo utilizada por usuários