Saltar a contenido

Obtener estudiantes asignados a un evento

✅ GET /api/v2/registration/students-assigned-to-event

Método/Ruta: GET /api/v2/registration/students-assigned-to-event
Auth: Bearer JWT (rol: admin/user)

Descripción: Obtiene la lista de estudiantes que ya están asignados a un evento específico (clase/evento del calendario). Útil para verificar qué alumnos están vinculados a una clase antes de realizar asignaciones adicionales.

Params

  • eventId (query, number, requerido) — ID del evento del calendario, ejemplo: 1271

Body

No aplica (GET request)

cURL

curl -X GET "http://localhost:7001/api/v2/registration/students-assigned-to-event?eventId=1271" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <TOKEN>"

Response (200 OK)

{
  "status": "success",
  "data": [
    {
      "studentId": 123,
      "fullName": "Juan García"
    },
    {
      "studentId": 456,
      "fullName": "María López"
    }
  ]
}

Errors

400 Bad Request - eventId no proporcionado

{
  "status": "error",
  "message": "eventId is required"
}

401 Unauthorized - Token inválido o expirado

{
  "status": "error",
  "message": "Invalid or expired token"
}

Notas

  • Este endpoint reemplaza a GET /api/v1/registration/all-by-subject-by-employee-by-center
  • Devuelve solo los estudiantes que están en la tabla EventStudent para el evento indicado
  • Los nombres se devuelven con espacios limpiados (trim)
  • Si el evento no tiene estudiantes asignados, devuelve un array vacío

Relacionado

  • GET /api/v2/registration/students-by-subject-and-center - Obtener estudiantes por materia y centro (con estado de matrícula)