Asistencia del grupo
Matriz de asistencia de un grupo (alumnos × actividades).
Matriz de asistencia del grupo
GET /turmas/{turmaId}/frequencia
Acceso: Exige la capacidad LER sobre grupo (params.turmaId). Estado de éxito: 200.
Parámetros de ruta
| Parámetro | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
turmaId | string (uuid) | sí | Id del grupo. |
Parámetros de consulta
| Parámetro | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
de | string | no | ^\d{4}-\d{2}-\d{2}$ | Fecha inicial de la ventana (AAAA-MM-DD), inclusive. |
ate | string | no | ^\d{4}-\d{2}-\d{2}$ | Fecha final de la ventana (AAAA-MM-DD), inclusive. |
Respuesta
| Campo | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
turma | object | sí | ||
turma.id | string (uuid) | sí | ||
turma.nome | string | sí | ||
hoje | Data | sí | Fecha de hoy en la zona horaria de la institución (para resaltar la columna «hoy»). | |
de | Data | sí | ||
ate | Data | sí | ||
atividades | lista de object | sí | Actividades en la ventana, por fecha y hora de inicio. | |
atividades[].id | string (uuid) | sí | ||
atividades[].data | Data | sí | ||
atividades[].horaInicio | string o nulo | sí | ||
atividades[].horaFim | string o nulo | sí | ||
atividades[].descricao | string o nulo | sí | ||
atividades[].obrigatoria | boolean | sí | ||
atividades[].cancelada | boolean | sí |
En caso de error: modelo ErroApi.
Ejemplo
bash
curl -X GET "$API/turmas/{turmaId}/frequencia" -H "Authorization: Bearer $TOKEN"