Criar Função Eclesiástica

Cria uma nova função eclesiástica no sistema

Este endpoint é do tipo: Protected

Descrição

Cria uma nova função eclesiástica no sistema com as seguintes funcionalidades:

Cadastra nome da função eclesiástica
Valida unicidade do nome da função
Requer autenticação JWT válida

Detalhes do Endpoint

VERBO

POST

URL BASE

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

ENDPOINT

/categories

Parâmetros do Corpo da Requisição

Parâmetro	Tipo	Obrigatório	Descrição
name	string	Sim	Nome da função eclesiástica (máx. 255 caracteres)

Exemplo de Requisição

{
  "name": "Reitor do Seminário"
}

Cabeçalhos

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

Respostas

Sucesso - 201

{
  "success": true,
  "data": {
    "id": 16,
    "name": "Reitor do Seminário",
    "description": "Responsável pela administração e formação do seminário",
    "created_at": "2024-01-01T00:00:00.000000Z",
    "updated_at": "2024-01-01T00:00:00.000000Z"
  },
  "message": "Função eclesiástica criada com sucesso"
}

Nota: A função eclesiástica é criada com status ativo por padrão e o nome deve ser único no sistema.

Erro - 422 (Dados inválidos)

{
  "success": false,
  "message": "Os dados fornecidos são inválidos.",
  "errors": {
    "name": ["O nome da categoria é obrigatório."],
    "description": ["A descrição não pode ter mais de 500 caracteres."]
  }
}

Erro - 401 (Token inválido)

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

Códigos de Resposta

Código	Descrição
201	Função eclesiástica criada com sucesso
401	Token inválido ou expirado
422	Dados de validação inválidos

Nunciatura Provista