Frequência

Matriz de frequência de uma turma (alunos × atividades).

Matriz de frequência da turma

GET /turmas/{turmaId}/frequencia

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.

Parâmetros de consulta

Parâmetro	Tipo	Obrigatório	Restrições	Descrição
de	string	não	^\d{4}-\d{2}-\d{2}$	Data inicial da janela (AAAA-MM-DD), inclusive.
ate	string	não	^\d{4}-\d{2}-\d{2}$	Data final da janela (AAAA-MM-DD), inclusive.

Resposta

FrequenciaTurma

Campo	Tipo	Obrigatório	Restrições	Descrição
turma	object	sim
turma.id	string (uuid)	sim
turma.nome	string	sim
hoje	Data	sim		Data de hoje no fuso da instituição (para destacar a coluna “hoje”).
de	Data	sim
ate	Data	sim
atividades	lista de object	sim		Atividades na janela, por data e hora de início.
atividades[].id	string (uuid)	sim
atividades[].data	Data	sim
atividades[].horaInicio	string ou nulo	sim
atividades[].horaFim	string ou nulo	sim
atividades[].descricao	string ou nulo	sim
atividades[].obrigatoria	boolean	sim
atividades[].cancelada	boolean	sim

Em caso de erro: modelo ErroApi.

Exemplo

curl -X GET "$API/turmas/{turmaId}/frequencia" -H "Authorization: Bearer $TOKEN"

---