Presença (aluno)
O que o aluno faz: pedir presença, editar o relato e gerar o QR da atividade.
Pede a presença em uma atividade
POST /me/atividades/{atividadeId}/presenca
Acesso: Qualquer pessoa autenticada. Limite: até 600 chamadas a cada 60 s por origem. Status de sucesso: 201.
Parâmetros de caminho
| Parâmetro | Tipo | Obrigatório | Restrições | Descrição |
|---|---|---|---|---|
atividadeId | string (uuid) | sim | Id da atividade. |
Corpo da requisição (PresencaSolicitar)
| Campo | Tipo | Obrigatório | Restrições | Descrição |
|---|---|---|---|---|
relato | string | não | a 2000 caracteres | Até 2000 caracteres. |
justificativa | string | não | a 2000 caracteres | Obrigatória quando o pedido cai em exceção. |
clienteId | string (uuid) | não | Gerado no aparelho: reenviar a fila offline não duplica. | |
capturadaEm | string (date-time) | não | Instante em que o aparelho capturou o pedido (fila offline). | |
lat | number | não | -90…90 | |
lng | number | não | -180…180 | |
precisaoM | integer | não | 0…1000000 |
Resposta
| Campo | Tipo | Obrigatório | Restrições | Descrição |
|---|---|---|---|---|
id | string (uuid) | sim | ||
atividadeId | string (uuid) | sim | ||
matriculaId | string (uuid) | sim | ||
estado | "SOLICITADA" | "CONFIRMADA" | "REJEITADA" | sim | ||
solicitadaEm | string | sim | ||
capturadaEm | string ou nulo | sim | ||
relato | string ou nulo | sim | ||
justificativa | string ou nulo | sim | ||
excecoes | lista de "FORA_DA_JANELA" | "FORA_DA_CERCA" | "OUTRO_DIA" | sim | ||
avaliadaEm | string ou nulo | sim | ||
comentarioAvaliador | string ou nulo | sim | ||
notas | lista de Nota | sim | Só a quem avalia a turma. O aluno vê as próprias notas pelo painel, depois que a turma as libera. | |
nivelSupervisao | NivelSupervisao ou nulo | não | Nível de supervisão dado pelo último avaliador; nulo = não informado. Só a quem avalia (o aluno o lê na avaliação, depois da liberação). | |
relatoEditadoEm | string ou nulo | não | Última edição do relato pelo aluno; nulo = nunca editado. Depois de avaliadaEm = editado depois da avaliação. |
Em caso de erro: modelo ErroApi.
Exemplo
curl -X POST "$API/me/atividades/{atividadeId}/presenca" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -d '{}'Edita o relato da própria presença
PUT /me/atividades/{atividadeId}/presenca/relato
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 |
|---|---|---|---|---|
atividadeId | string (uuid) | sim | Id da atividade. |
Corpo da requisição (RelatoEditar)
| Campo | Tipo | Obrigatório | Restrições | Descrição |
|---|---|---|---|---|
relato | string | sim | a 2000 caracteres |
Resposta
| Campo | Tipo | Obrigatório | Restrições | Descrição |
|---|---|---|---|---|
id | string (uuid) | sim | ||
atividadeId | string (uuid) | sim | ||
matriculaId | string (uuid) | sim | ||
estado | "SOLICITADA" | "CONFIRMADA" | "REJEITADA" | sim | ||
solicitadaEm | string | sim | ||
capturadaEm | string ou nulo | sim | ||
relato | string ou nulo | sim | ||
justificativa | string ou nulo | sim | ||
excecoes | lista de "FORA_DA_JANELA" | "FORA_DA_CERCA" | "OUTRO_DIA" | sim | ||
avaliadaEm | string ou nulo | sim | ||
comentarioAvaliador | string ou nulo | sim | ||
notas | lista de Nota | sim | Só a quem avalia a turma. O aluno vê as próprias notas pelo painel, depois que a turma as libera. | |
nivelSupervisao | NivelSupervisao ou nulo | não | Nível de supervisão dado pelo último avaliador; nulo = não informado. Só a quem avalia (o aluno o lê na avaliação, depois da liberação). | |
relatoEditadoEm | string ou nulo | não | Última edição do relato pelo aluno; nulo = nunca editado. Depois de avaliadaEm = editado depois da avaliação. |
Em caso de erro: modelo ErroApi.
Exemplo
curl -X PUT "$API/me/atividades/{atividadeId}/presenca/relato" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -d '{"relato":"texto"}'Gera o QR da atividade para o aluno
GET /me/atividades/{atividadeId}/qr
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 |
|---|---|---|---|---|
atividadeId | string (uuid) | sim | Id da atividade. |
Resposta
| Campo | Tipo | Obrigatório | Restrições | Descrição |
|---|---|---|---|---|
token | string | sim | ||
expiraEm | string | sim |
Em caso de erro: modelo ErroApi.
Exemplo
curl -X GET "$API/me/atividades/{atividadeId}/qr" -H "Authorization: Bearer $TOKEN"