Deletar aluno

Descrição

Endpoint para deletar um aluno do sistema realizando soft delete.

📋 Detalhes da Requisição

URL

DELETE https://seudominio.com/api/students/{id}

Headers Obrigatórios

Parâmetros de Rota

id (int, obrigatório): ID do aluno.

📤 Respostas da API

✅ Sucesso (200 OK)

{
  "success": true,
  "message": "Aluno deletado com sucesso",
  "data": null,
  "timestamp": "2025-01-28 14:30:00",
  "status_code": 200
}

❌ Erro - ID Inválido (400 Bad Request)

{
  "success": false,
  "message": "ID inválido",
  "errors": [],
  "timestamp": "2025-01-28 14:30:00",
  "status_code": 400
}

❌ Erro - Aluno Não Encontrado (404 Not Found)

{
  "success": false,
  "message": "Aluno não encontrado",
  "errors": [],
  "timestamp": "2025-01-28 14:30:00",
  "status_code": 404
}

❌ Erro - Não Autorizado (401 Unauthorized)

{
  "success": false,
  "message": "Unauthorized - Invalid or missing token",
  "errors": [],
  "timestamp": "2025-01-28 14:30:00",
  "status_code": 401
}

⚠️ Códigos de Status HTTP

Código	Descrição	Quando Ocorre
`200`	OK	Aluno deletado com sucesso
`400`	Bad Request	ID inválido ou menor que 1
`401`	Unauthorized	Token inválido ou não fornecido
`404`	Not Found	Aluno não encontrado
`500`	Internal Server Error	Erro interno do servidor

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

application/json

Body

Exemplo

{
    "success": true,
    "message": "Aluno deletado com sucesso",
    "data": "2025-10-31",
    "timestamp": "2025-10-31 01:15:13",
    "status_code": 200
}

Descrição#

📋 Detalhes da Requisição#

URL#

Headers Obrigatórios#

Parâmetros de Rota#

📤 Respostas da API#

✅ Sucesso (200 OK)#

❌ Erro - ID Inválido (400 Bad Request)#

❌ Erro - Aluno Não Encontrado (404 Not Found)#

❌ Erro - Não Autorizado (401 Unauthorized)#

⚠️ Códigos de Status HTTP#

Requisição

Exemplos de Requisição

Respostas