Feedback final
Feedback de cierre que el equipo escribe para cada alumno.
Mi feedback final en un grupo
GET /me/turmas/{turmaId}/feedback-final
Acceso: Cualquier persona autenticada. Límite: hasta 600 llamadas cada 60 s por origen. Estado de éxito: 200.
Parámetros de ruta
| Parámetro | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
turmaId | string (uuid) | sí | Id del grupo. |
Respuesta
| Campo | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
turma | object | sí | ||
turma.id | string (uuid) | sí | ||
turma.nome | string | sí | ||
liberado | boolean | sí | ||
liberaEm | Data o nulo | sí | ||
criterios | lista de CriterioDto | sí | ||
feedbacks | lista de FeedbackFinalDto | sí |
En caso de error: modelo ErroApi.
Ejemplo
curl -X GET "$API/me/turmas/{turmaId}/feedback-final" -H "Authorization: Bearer $TOKEN"Lista los feedbacks finales del grupo, por alumno
GET /turmas/{turmaId}/feedback-final
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. |
Respuesta
| Campo | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
turma | object | sí | ||
turma.id | string (uuid) | sí | ||
turma.nome | string | sí | ||
turma.dataInicio | Data o nulo | sí | ||
turma.dataFim | Data o nulo | sí | ||
janela | JanelaFeedback | sí | ||
podeEscrever | boolean | sí | ||
verTudo | boolean | sí | ||
itens | lista de object | sí | ||
itens[].matriculaId | string (uuid) | sí | ||
itens[].aluno | object | sí | ||
itens[].aluno.id | string (uuid) | sí | ||
itens[].aluno.nome | string | sí | ||
itens[].meuEm | string o nulo | sí |
En caso de error: modelo ErroApi.
Ejemplo
curl -X GET "$API/turmas/{turmaId}/feedback-final" -H "Authorization: Bearer $TOKEN"Lee el feedback final de un alumno
GET /turmas/{turmaId}/matriculas/{matriculaId}/feedback-final
Acceso: Exige la capacidad LER sobre grupo (params.turmaId). Estado de éxito: 200.
Parámetros de ruta
| Parámetro | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
matriculaId | string (uuid) | sí | Id de la matrícula. | |
turmaId | string (uuid) | sí | Id del grupo. |
Respuesta
| Campo | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
matriculaId | string (uuid) | sí | ||
turma | object | sí | ||
turma.id | string (uuid) | sí | ||
turma.nome | string | sí | ||
turma.dataInicio | Data o nulo | sí | ||
turma.dataFim | Data o nulo | sí | ||
aluno | object | sí | ||
aluno.id | string (uuid) | sí | ||
aluno.nome | string | sí | ||
janela | JanelaFeedback | sí | ||
criterios | lista de CriterioDto | sí | ||
meu | FeedbackFinalDto o nulo | sí | ||
podeEscrever | boolean | sí | ||
verTudo | boolean | sí |
En caso de error: modelo ErroApi.
Ejemplo
curl -X GET "$API/turmas/{turmaId}/matriculas/{matriculaId}/feedback-final" -H "Authorization: Bearer $TOKEN"Graba el feedback final de un alumno
PUT /turmas/{turmaId}/matriculas/{matriculaId}/feedback-final
Acceso: Exige la capacidad AVALIAR sobre grupo (params.turmaId). Estado de éxito: 200.
Parámetros de ruta
| Parámetro | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
matriculaId | string (uuid) | sí | Id de la matrícula. | |
turmaId | string (uuid) | sí | Id del grupo. |
Cuerpo de la solicitud (FeedbackFinalEscrever)
| Campo | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
notas | lista de object | sí | 0–200 elementos | |
notas[].criterioId | string (uuid) | sí | ||
notas[].valor | integer o nulo | sí | ||
comentario | string | sí | 1–4000 caracteres | |
comentarioInterno | string o nulo | no | a 4000 caracteres |
Respuesta
| Campo | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
matriculaId | string (uuid) | sí | ||
turma | object | sí | ||
turma.id | string (uuid) | sí | ||
turma.nome | string | sí | ||
turma.dataInicio | Data o nulo | sí | ||
turma.dataFim | Data o nulo | sí | ||
aluno | object | sí | ||
aluno.id | string (uuid) | sí | ||
aluno.nome | string | sí | ||
janela | JanelaFeedback | sí | ||
criterios | lista de CriterioDto | sí | ||
meu | FeedbackFinalDto o nulo | sí | ||
podeEscrever | boolean | sí | ||
verTudo | boolean | sí |
En caso de error: modelo ErroApi.
Ejemplo
curl -X PUT "$API/turmas/{turmaId}/matriculas/{matriculaId}/feedback-final" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -d '{"notas":[{"criterioId":"0198a000-0000-7000-8000-000000000001","valor":1}],"comentario":"texto"}'