Excluir Escola

Endpoint autenticado para excluir uma escola vinculada ao motorista logado.

Rota URL

• Rota: /escola/:id
• Tipo: DELETE
• Nota: rota protegida. É necessário enviar o cookie token de autenticação.

Dados Esperados

Cabeçalho (Cookie)

• token: String (JWT da sessão).

Parâmetro de rota

• id: Número inteiro positivo que identifica a escola.

Exemplo

DELETE /escola/1

Respostas

• msg: Mensagem que descreve o resultado da solicitação.
• erro: Objeto com os erros de validação do id, quando ele for inválido.

Exemplo de sucesso

{
  "msg": "Escola excluída com sucesso."
}

Somente uma escola vinculada ao motorista autenticado pode ser excluída. Quando o id não existe ou pertence a outro motorista, o endpoint responde com 404.

Exemplo de escola não encontrada

{
  "msg": "Escola não encontrada."
}

Status

• 200: Escola excluída com sucesso.
• 400: id ausente, não numérico, igual a zero ou negativo.
• 401: Sessão ausente ou inválida, inclusive quando o motorista da sessão não existe mais ou está com exclusão agendada.
• 404: Escola não encontrada para o motorista autenticado.
• 409: A integridade referencial do banco impediu a exclusão porque existem alunos vinculados à escola.
• 500: Erro interno no servidor.