Matricular cursos

Descrição

Endpoint para matricular um ou mais alunos em um ou mais cursos.

📋 Detalhes da Requisição

URL

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

Headers Obrigatórios

Corpo da Requisição (JSON)

{
  "students": [123, 456],
  "courses": [789, 101112]
}

📤 Respostas da API

✅ Sucesso (201 Created)

{
  "success": true,
  "message": "Matrículas realizadas com sucesso: 4 matrícula(s)",
  "data": {
    "success_count": 4,
    "error_count": 0,
    "total_processed": 4,
    "message": "Matrículas realizadas com sucesso: 4 matrícula(s)"
  },
  "timestamp": "2025-01-28 10:30:00",
  "status_code": 201
}

✅ Sucesso Parcial (201 Created)

{
  "success": true,
  "message": "Matrículas realizadas parcialmente: 2 sucesso(s), 2 erro(s)",
  "data": {
    "success_count": 2,
    "error_count": 2,
    "total_processed": 4,
    "errors": [
      "Erro ao matricular aluno Renato no curso Windows 11: Aluno ja matriculado nesse curso",
      "Erro ao matricular aluno Pedro no curso Windows 11: Aluno nao encontrado"
    ],
    "message": "Matrículas realizadas parcialmente: 2 sucesso(s), 2 erro(s)"
  },
  "timestamp": "2025-01-28 10:30:00",
  "status_code": 201
}

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

{
  "success": false,
  "message": "Os campos students e courses são obrigatórios e não podem estar vazios",
  "errors": [],
  "timestamp": "2025-01-28 10:30:00",
  "status_code": 400
}

❌ Erro - Nenhuma Matrícula Realizada (400 Bad Request)

{
  "success": false,
  "message": "Nenhuma matrícula foi realizada com sucesso",
  "errors": [
    "Erro ao matricular aluno 123 no curso 789: Aluno ja matriculado nesse curso",
    "Erro ao matricular aluno 456 no curso 789: Aluno nao encontrado"
  ],
  "timestamp": "2025-01-28 10:30:00",
  "status_code": 400
}

❌ 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
`students`	array	✅ Sim	Array de IDs dos alunos	`[123, 456]`
`courses`	array	✅ Sim	Array de IDs dos cursos	`[789, 101112]`

⚠️ Códigos de Status HTTP

Código	Descrição	Quando Ocorre
`201`	Created	Pelo menos uma matrícula foi realizada com sucesso
`400`	Bad Request	Dados inválidos, arrays vazios ou nenhuma matrícula realizada
`401`	Unauthorized	Token inválido ou não fornecido
`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 (201 Created)#

✅ Sucesso Parcial (201 Created)#

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

❌ Erro - Nenhuma Matrícula Realizada (400 Bad Request)#

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

🔍 Campos da Requisição#

⚠️ Códigos de Status HTTP#

Requisição

Exemplos de Requisição

Respostas