Evolução
Evolução longitudinal do aluno por disciplina.
Lista alunos com a evolução que a pessoa pode ver
GET /evolucao/alunos
Acesso: Qualquer pessoa autenticada. Limite: até 300 chamadas a cada 60 s por origem. Status de sucesso: 200.
Parâmetros de consulta
| Parâmetro | Tipo | Obrigatório | Restrições | Descrição |
|---|---|---|---|---|
busca | string | não | a 100 caracteres | Texto para buscar (nome ou e-mail, conforme a rota). |
limite | integer | não | 1…100; padrão: 50 | Quantos itens por página (1 a 200; o padrão varia por rota, em geral 50). |
Resposta
| Campo | Tipo | Obrigatório | Restrições | Descrição |
|---|---|---|---|---|
items | lista de EvolucaoAlunoItem | sim |
Em caso de erro: modelo ErroApi.
Exemplo
bash
curl -X GET "$API/evolucao/alunos" -H "Authorization: Bearer $TOKEN"Evolução de um aluno (por matrícula)
GET /matriculas/{matriculaId}/evolucao
Acesso: Qualquer pessoa autenticada. Limite: até 300 chamadas a cada 60 s por origem. Status de sucesso: 200.
Parâmetros de caminho
| Parâmetro | Tipo | Obrigatório | Restrições | Descrição |
|---|---|---|---|---|
matriculaId | string (uuid) | sim | Id da matrícula. |
Resposta
| Campo | Tipo | Obrigatório | Restrições | Descrição |
|---|---|---|---|---|
aluno | object | sim | ||
aluno.id | string (uuid) | sim | ||
aluno.nome | string | sim | ||
disciplinas | lista de EvolucaoDisciplina | sim | ||
turmasNaoLiberadas | integer | sim | 0… | Só na visão do próprio aluno: turmas dele cujas notas ainda não foram liberadas (não entram nas séries). |
Em caso de erro: modelo ErroApi.
Exemplo
bash
curl -X GET "$API/matriculas/{matriculaId}/evolucao" -H "Authorization: Bearer $TOKEN"Evolução da própria pessoa por disciplina
GET /me/evolucao
Acesso: Qualquer pessoa autenticada. Limite: até 300 chamadas a cada 60 s por origem. Status de sucesso: 200.
Resposta
| Campo | Tipo | Obrigatório | Restrições | Descrição |
|---|---|---|---|---|
aluno | object | sim | ||
aluno.id | string (uuid) | sim | ||
aluno.nome | string | sim | ||
disciplinas | lista de EvolucaoDisciplina | sim | ||
turmasNaoLiberadas | integer | sim | 0… | Só na visão do próprio aluno: turmas dele cujas notas ainda não foram liberadas (não entram nas séries). |
Em caso de erro: modelo ErroApi.
Exemplo
bash
curl -X GET "$API/me/evolucao" -H "Authorization: Bearer $TOKEN"