Actividades
Calendario de actividades de un grupo (clases, guardias, prácticas).
Lista las actividades de un grupo
GET /turmas/{turmaId}/atividades
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 |
|---|---|---|---|---|
busca | string | no | a 100 caracteres | Texto para buscar (nombre o correo, según la ruta). |
limite | integer | no | 1…200; por defecto: 50 | Cuántos elementos por página (1 a 200; el valor predeterminado varía por ruta, en general 50). |
deslocamento | integer | no | 0…100000; por defecto: 0 | Cuántos elementos saltar, para paginar (hasta 100000). |
inativos | "true" | "false" | no | por defecto: "false" | true incluye también los registros inactivos. |
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
lista de AtividadeDto (+ total)
| Campo | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
id | string (uuid) | sí | ||
turmaId | string (uuid) | sí | ||
data | Data | sí | ||
horaInicio | Hora o nulo | sí | ||
horaFim | Hora o nulo | sí | ||
atividadeProfissionalId | string (uuid) o nulo | sí | ||
atividadeProfissionalNome | string o nulo | sí | Nombre del elemento del catálogo (para listas y pantallas que no cargan el catálogo). | |
descricao | string o nulo | sí | ||
observacoes | string o nulo | sí | ||
local | string o nulo | sí | ||
obrigatoria | boolean | sí | ||
cancelada | boolean | sí | ||
cercaAtiva | boolean | sí | ||
cercaRaioM | integer o nulo | sí |
En caso de error: modelo ErroApi.
Ejemplo
curl -X GET "$API/turmas/{turmaId}/atividades" -H "Authorization: Bearer $TOKEN"Crea una actividad en el grupo
POST /turmas/{turmaId}/atividades
Acceso: Exige la capacidad CADASTRAR sobre grupo (params.turmaId). Estado de éxito: 201.
Parámetros de ruta
| Parámetro | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
turmaId | string (uuid) | sí | Id del grupo. |
Cuerpo de la solicitud (AtividadeCriar)
| Campo | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
data | Data | sí | ||
atividadeProfissionalId | string (uuid) o nulo | no | ||
horaInicio | Hora o nulo | no | ||
horaFim | Hora o nulo | no | ||
descricao | string o nulo | no | a 2000 caracteres | |
observacoes | string o nulo | no | a 5000 caracteres | |
local | string o nulo | no | a 500 caracteres | |
obrigatoria | boolean | no | ||
cancelada | boolean | no | ||
cercaAtiva | boolean | no | ||
cercaRaioM | integer o nulo | no | 10…5000 | |
lat | number o nulo | no | -90…90 | |
lng | number o nulo | no | -180…180 |
Respuesta
| Campo | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
id | string (uuid) | sí | ||
turmaId | string (uuid) | sí | ||
data | Data | sí | ||
horaInicio | Hora o nulo | sí | ||
horaFim | Hora o nulo | sí | ||
atividadeProfissionalId | string (uuid) o nulo | sí | ||
atividadeProfissionalNome | string o nulo | sí | Nombre del elemento del catálogo (para listas y pantallas que no cargan el catálogo). | |
descricao | string o nulo | sí | ||
observacoes | string o nulo | sí | ||
local | string o nulo | sí | ||
obrigatoria | boolean | sí | ||
cancelada | boolean | sí | ||
cercaAtiva | boolean | sí | ||
cercaRaioM | integer o nulo | sí |
En caso de error: modelo ErroApi.
Ejemplo
curl -X POST "$API/turmas/{turmaId}/atividades" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -d '{"data":"2026-03-10"}'Lee una actividad
GET /turmas/{turmaId}/atividades/{atividadeId}
Acceso: Exige la capacidad LER sobre grupo (params.turmaId). Estado de éxito: 200.
Parámetros de ruta
| Parámetro | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
atividadeId | string (uuid) | sí | Id de la actividad. | |
turmaId | string (uuid) | sí | Id del grupo. |
Respuesta
| Campo | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
id | string (uuid) | sí | ||
turmaId | string (uuid) | sí | ||
data | Data | sí | ||
horaInicio | Hora o nulo | sí | ||
horaFim | Hora o nulo | sí | ||
atividadeProfissionalId | string (uuid) o nulo | sí | ||
atividadeProfissionalNome | string o nulo | sí | Nombre del elemento del catálogo (para listas y pantallas que no cargan el catálogo). | |
descricao | string o nulo | sí | ||
observacoes | string o nulo | sí | ||
local | string o nulo | sí | ||
obrigatoria | boolean | sí | ||
cancelada | boolean | sí | ||
cercaAtiva | boolean | sí | ||
cercaRaioM | integer o nulo | sí |
En caso de error: modelo ErroApi.
Ejemplo
curl -X GET "$API/turmas/{turmaId}/atividades/{atividadeId}" -H "Authorization: Bearer $TOKEN"Elimina una actividad (si no tiene asistencia)
DELETE /turmas/{turmaId}/atividades/{atividadeId}
Solo es posible si la actividad aún no tiene asistencia; de lo contrario, cancélela en vez de eliminarla.
Acceso: Exige la capacidad CADASTRAR sobre grupo (params.turmaId). Estado de éxito: 204.
Parámetros de ruta
| Parámetro | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
atividadeId | string (uuid) | sí | Id de la actividad. | |
turmaId | string (uuid) | sí | Id del grupo. |
Respuesta
Sin cuerpo en la respuesta.
En caso de error: modelo ErroApi.
Ejemplo
curl -X DELETE "$API/turmas/{turmaId}/atividades/{atividadeId}" -H "Authorization: Bearer $TOKEN"Actualiza una actividad
PATCH /turmas/{turmaId}/atividades/{atividadeId}
Acceso: Exige la capacidad CADASTRAR sobre grupo (params.turmaId). Estado de éxito: 200.
Parámetros de ruta
| Parámetro | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
atividadeId | string (uuid) | sí | Id de la actividad. | |
turmaId | string (uuid) | sí | Id del grupo. |
Cuerpo de la solicitud (AtividadeAtualizar)
| Campo | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
data | Data | no | ||
atividadeProfissionalId | string (uuid) o nulo | no | ||
horaInicio | Hora o nulo | no | ||
horaFim | Hora o nulo | no | ||
descricao | string o nulo | no | a 2000 caracteres | |
observacoes | string o nulo | no | a 5000 caracteres | |
local | string o nulo | no | a 500 caracteres | |
obrigatoria | boolean | no | ||
cancelada | boolean | no | ||
cercaAtiva | boolean | no | ||
cercaRaioM | integer o nulo | no | 10…5000 | |
lat | number o nulo | no | -90…90 | |
lng | number o nulo | no | -180…180 |
Respuesta
| Campo | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
id | string (uuid) | sí | ||
turmaId | string (uuid) | sí | ||
data | Data | sí | ||
horaInicio | Hora o nulo | sí | ||
horaFim | Hora o nulo | sí | ||
atividadeProfissionalId | string (uuid) o nulo | sí | ||
atividadeProfissionalNome | string o nulo | sí | Nombre del elemento del catálogo (para listas y pantallas que no cargan el catálogo). | |
descricao | string o nulo | sí | ||
observacoes | string o nulo | sí | ||
local | string o nulo | sí | ||
obrigatoria | boolean | sí | ||
cancelada | boolean | sí | ||
cercaAtiva | boolean | sí | ||
cercaRaioM | integer o nulo | sí |
En caso de error: modelo ErroApi.
Ejemplo
curl -X PATCH "$API/turmas/{turmaId}/atividades/{atividadeId}" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -d '{}'