Editar Escola

Endpoint autenticado para editar os dados de uma escola vinculada ao motorista logado.

Rota URL

• Rota: /escola/:id
• Tipo: PATCH
• 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.

Corpo (Body)

• nome: String entre 1 e 200 caracteres (opcional).
• endereco: String entre 5 e 255 caracteres (opcional).
• tel: String com exatamente 11 dígitos (opcional).
• latitude: Número entre -90 e 90 (opcional).
• longitude: Número entre -180 e 180 (opcional).

É necessário enviar pelo menos um campo para edição. O campo tel deve ser enviado sem máscara.

Exemplo de rota

PATCH /escola/1

Exemplo de corpo

{
  "nome": "Colégio Caminhos do Saber"
}

Respostas

• msg: Mensagem que descreve o resultado da solicitação.
• erro: Objeto com os erros de cada campo quando a validação falha.

Exemplo de sucesso

{
  "msg": "Escola editada com sucesso."
}

Somente uma escola vinculada ao motorista autenticado pode ser alterada. 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 editada com sucesso.
• 400: id ausente, dados inválidos ou nenhum campo reconhecido para edição.
• 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.
• 413: Corpo da requisição excede o limite aceito pela API.
• 500: Erro interno no servidor.