Feedback final
Feedback de encerramento que a equipe escreve para cada aluno.
Meu feedback final em uma turma
GET /me/turmas/{turmaId}/feedback-final
Acesso: Qualquer pessoa autenticada. Limite: até 600 chamadas a cada 60 s por origem. Status de sucesso: 200.
Parâmetros de caminho
| Parâmetro | Tipo | Obrigatório | Restrições | Descrição |
|---|---|---|---|---|
turmaId | string (uuid) | sim | Id da turma. |
Resposta
| Campo | Tipo | Obrigatório | Restrições | Descrição |
|---|---|---|---|---|
turma | object | sim | ||
turma.id | string (uuid) | sim | ||
turma.nome | string | sim | ||
liberado | boolean | sim | ||
liberaEm | Data ou nulo | sim | ||
criterios | lista de CriterioDto | sim | ||
feedbacks | lista de FeedbackFinalDto | sim |
Em caso de erro: modelo ErroApi.
Exemplo
curl -X GET "$API/me/turmas/{turmaId}/feedback-final" -H "Authorization: Bearer $TOKEN"Lista os feedbacks finais da turma, por aluno
GET /turmas/{turmaId}/feedback-final
Acesso: Exige a capacidade LER sobre turma (params.turmaId). Status de sucesso: 200.
Parâmetros de caminho
| Parâmetro | Tipo | Obrigatório | Restrições | Descrição |
|---|---|---|---|---|
turmaId | string (uuid) | sim | Id da turma. |
Resposta
| Campo | Tipo | Obrigatório | Restrições | Descrição |
|---|---|---|---|---|
turma | object | sim | ||
turma.id | string (uuid) | sim | ||
turma.nome | string | sim | ||
turma.dataInicio | Data ou nulo | sim | ||
turma.dataFim | Data ou nulo | sim | ||
janela | JanelaFeedback | sim | ||
podeEscrever | boolean | sim | ||
verTudo | boolean | sim | ||
itens | lista de object | sim | ||
itens[].matriculaId | string (uuid) | sim | ||
itens[].aluno | object | sim | ||
itens[].aluno.id | string (uuid) | sim | ||
itens[].aluno.nome | string | sim | ||
itens[].meuEm | string ou nulo | sim |
Em caso de erro: modelo ErroApi.
Exemplo
curl -X GET "$API/turmas/{turmaId}/feedback-final" -H "Authorization: Bearer $TOKEN"Lê o feedback final de um aluno
GET /turmas/{turmaId}/matriculas/{matriculaId}/feedback-final
Acesso: Exige a capacidade LER sobre turma (params.turmaId). 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. | |
turmaId | string (uuid) | sim | Id da turma. |
Resposta
| Campo | Tipo | Obrigatório | Restrições | Descrição |
|---|---|---|---|---|
matriculaId | string (uuid) | sim | ||
turma | object | sim | ||
turma.id | string (uuid) | sim | ||
turma.nome | string | sim | ||
turma.dataInicio | Data ou nulo | sim | ||
turma.dataFim | Data ou nulo | sim | ||
aluno | object | sim | ||
aluno.id | string (uuid) | sim | ||
aluno.nome | string | sim | ||
janela | JanelaFeedback | sim | ||
criterios | lista de CriterioDto | sim | ||
meu | FeedbackFinalDto ou nulo | sim | ||
podeEscrever | boolean | sim | ||
verTudo | boolean | sim |
Em caso de erro: modelo ErroApi.
Exemplo
curl -X GET "$API/turmas/{turmaId}/matriculas/{matriculaId}/feedback-final" -H "Authorization: Bearer $TOKEN"Grava o feedback final de um aluno
PUT /turmas/{turmaId}/matriculas/{matriculaId}/feedback-final
Acesso: Exige a capacidade AVALIAR sobre turma (params.turmaId). 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. | |
turmaId | string (uuid) | sim | Id da turma. |
Corpo da requisição (FeedbackFinalEscrever)
| Campo | Tipo | Obrigatório | Restrições | Descrição |
|---|---|---|---|---|
notas | lista de object | sim | 0–200 itens | |
notas[].criterioId | string (uuid) | sim | ||
notas[].valor | integer ou nulo | sim | ||
comentario | string | sim | 1–4000 caracteres | |
comentarioInterno | string ou nulo | não | a 4000 caracteres |
Resposta
| Campo | Tipo | Obrigatório | Restrições | Descrição |
|---|---|---|---|---|
matriculaId | string (uuid) | sim | ||
turma | object | sim | ||
turma.id | string (uuid) | sim | ||
turma.nome | string | sim | ||
turma.dataInicio | Data ou nulo | sim | ||
turma.dataFim | Data ou nulo | sim | ||
aluno | object | sim | ||
aluno.id | string (uuid) | sim | ||
aluno.nome | string | sim | ||
janela | JanelaFeedback | sim | ||
criterios | lista de CriterioDto | sim | ||
meu | FeedbackFinalDto ou nulo | sim | ||
podeEscrever | boolean | sim | ||
verTudo | boolean | sim |
Em caso de erro: modelo ErroApi.
Exemplo
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"}'