Evolución
Evolución longitudinal del alumno por asignatura.
Lista alumnos con la evolución que la persona puede ver
GET /evolucao/alunos
Acceso: Cualquier persona autenticada. Límite: hasta 300 llamadas cada 60 s por origen. Estado de éxito: 200.
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…100; por defecto: 50 | Cuántos elementos por página (1 a 200; el valor predeterminado varía por ruta, en general 50). |
Respuesta
| Campo | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
items | lista de EvolucaoAlunoItem | sí |
En caso de error: modelo ErroApi.
Ejemplo
bash
curl -X GET "$API/evolucao/alunos" -H "Authorization: Bearer $TOKEN"Evolución de un alumno (por matrícula)
GET /matriculas/{matriculaId}/evolucao
Acceso: Cualquier persona autenticada. Límite: hasta 300 llamadas cada 60 s por origen. Estado de éxito: 200.
Parámetros de ruta
| Parámetro | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
matriculaId | string (uuid) | sí | Id de la matrícula. |
Respuesta
| Campo | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
aluno | object | sí | ||
aluno.id | string (uuid) | sí | ||
aluno.nome | string | sí | ||
disciplinas | lista de EvolucaoDisciplina | sí | ||
turmasNaoLiberadas | integer | sí | 0… | Solo en la vista del propio alumno: grupos suyos cuyas notas aún no se liberaron (no entran en las series). |
En caso de error: modelo ErroApi.
Ejemplo
bash
curl -X GET "$API/matriculas/{matriculaId}/evolucao" -H "Authorization: Bearer $TOKEN"Evolución de la propia persona por asignatura
GET /me/evolucao
Acceso: Cualquier persona autenticada. Límite: hasta 300 llamadas cada 60 s por origen. Estado de éxito: 200.
Respuesta
| Campo | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
aluno | object | sí | ||
aluno.id | string (uuid) | sí | ||
aluno.nome | string | sí | ||
disciplinas | lista de EvolucaoDisciplina | sí | ||
turmasNaoLiberadas | integer | sí | 0… | Solo en la vista del propio alumno: grupos suyos cuyas notas aún no se liberaron (no entran en las series). |
En caso de error: modelo ErroApi.
Ejemplo
bash
curl -X GET "$API/me/evolucao" -H "Authorization: Bearer $TOKEN"