Remover cursos

Descrição

Endpoint para remover um ou mais cursos de um aluno específico.

📋 Detalhes da Requisição

URL

DELETE https://seudominio.com/api/courses

Headers Obrigatórios

Corpo da Requisição (JSON)

{
  "student_id": 123,
  "courses": [789, 101112]
}

📤 Respostas da API

✅ Sucesso (200 OK)

{
  "success": true,
  "message": "Remoções realizadas com sucesso: 2 remoção(ões)",
  "data": {
    "success_count": 2,
    "error_count": 0,
    "total_processed": 2,
    "message": "Remoções realizadas com sucesso: 2 remoção(ões)"
  },
  "timestamp": "2025-01-28 10:30:00",
  "status_code": 200
}

✅ Sucesso Parcial (200 OK)

{
  "success": true,
  "message": "Remoções realizadas parcialmente: 1 sucesso(s), 1 erro(s)",
  "data": {
    "success_count": 1,
    "error_count": 1,
    "total_processed": 2,
    "errors": [
      "Erro ao remover curso Windows 11 do aluno Renato: Curso não encontrado na matrícula"
    ],
    "message": "Remoções realizadas parcialmente: 1 sucesso(s), 1 erro(s)"
  },
  "timestamp": "2025-01-28 10:30:00",
  "status_code": 200
}

❌ Erro - Dados Inválidos (400 Bad Request)

{
  "success": false,
  "message": "O campo student_id é obrigatório e deve ser um número inteiro positivo",
  "errors": [],
  "timestamp": "2025-01-28 10: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 10:30:00",
  "status_code": 404
}

❌ Erro - Token Inválido (401 Unauthorized)

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

🔍 Campos da Requisição

Campo	Tipo	Obrigatório	Descrição	Exemplo
`student_id`	int	✅ Sim	ID do aluno	`123`
`courses`	array	✅ Sim	Array de IDs dos cursos a remover	`[789, 101112]`

⚠️ Códigos de Status HTTP

Código	Descrição	Quando Ocorre
`200`	OK	Pelo menos uma remoção foi realizada com sucesso
`400`	Bad Request	Dados inválidos ou nenhuma remoção realizada
`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": "string",
    "data": {
        "success_count": 0,
        "error_count": 0,
        "total_processed": 0,
        "message": "string"
    },
    "timestamp": "string",
    "status_code": 0
}

Descrição#

📋 Detalhes da Requisição#

URL#

Headers Obrigatórios#

Corpo da Requisição (JSON)#

📤 Respostas da API#

✅ Sucesso (200 OK)#

✅ Sucesso Parcial (200 OK)#

❌ Erro - Dados Inválidos (400 Bad Request)#

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

❌ Erro - Token Inválido (401 Unauthorized)#

🔍 Campos da Requisição#

⚠️ Códigos de Status HTTP#

Requisição

Exemplos de Requisição

Respostas