Attendance (student)
What the student does: request attendance, edit the account and generate the activity QR.
Request attendance for an activity
POST /me/atividades/{atividadeId}/presenca
Access: Any signed-in person. Rate limit: up to 600 calls every 60 s per origin. Success status: 201.
Path parameters
| Parameter | Type | Required | Constraints | Description |
|---|---|---|---|---|
atividadeId | string (uuid) | yes | Activity id. |
Request body (PresencaSolicitar)
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
relato | string | no | to 2000 characters | Up to 2000 characters. |
justificativa | string | no | to 2000 characters | Required when the request falls under an exception. |
clienteId | string (uuid) | no | Generated on the device: resending the offline queue does not duplicate. | |
capturadaEm | string (date-time) | no | The moment the device captured the request (offline queue). | |
lat | number | no | -90…90 | |
lng | number | no | -180…180 | |
precisaoM | integer | no | 0…1000000 |
Response
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
id | string (uuid) | yes | ||
atividadeId | string (uuid) | yes | ||
matriculaId | string (uuid) | yes | ||
estado | "SOLICITADA" | "CONFIRMADA" | "REJEITADA" | yes | ||
solicitadaEm | string | yes | ||
capturadaEm | string or null | yes | ||
relato | string or null | yes | ||
justificativa | string or null | yes | ||
excecoes | list of "FORA_DA_JANELA" | "FORA_DA_CERCA" | "OUTRO_DIA" | yes | ||
avaliadaEm | string or null | yes | ||
comentarioAvaliador | string or null | yes | ||
notas | list of Nota | yes | Only for those who assess the class. Students see their grades in the panel after the class releases them. | |
nivelSupervisao | NivelSupervisao or null | no | Supervision level given by the last assessor; null = not provided. Only for assessors (students read it in the assessment after release). | |
relatoEditadoEm | string or null | no | Last edit of the account by the student; null = never edited. After avaliadaEm = edited after the assessment. |
On error: ErroApi model.
Example
bash
curl -X POST "$API/me/atividades/{atividadeId}/presenca" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -d '{}'Edit the account of your own attendance
PUT /me/atividades/{atividadeId}/presenca/relato
Access: Any signed-in person. Rate limit: up to 600 calls every 60 s per origin. Success status: 200.
Path parameters
| Parameter | Type | Required | Constraints | Description |
|---|---|---|---|---|
atividadeId | string (uuid) | yes | Activity id. |
Request body (RelatoEditar)
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
relato | string | yes | to 2000 characters |
Response
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
id | string (uuid) | yes | ||
atividadeId | string (uuid) | yes | ||
matriculaId | string (uuid) | yes | ||
estado | "SOLICITADA" | "CONFIRMADA" | "REJEITADA" | yes | ||
solicitadaEm | string | yes | ||
capturadaEm | string or null | yes | ||
relato | string or null | yes | ||
justificativa | string or null | yes | ||
excecoes | list of "FORA_DA_JANELA" | "FORA_DA_CERCA" | "OUTRO_DIA" | yes | ||
avaliadaEm | string or null | yes | ||
comentarioAvaliador | string or null | yes | ||
notas | list of Nota | yes | Only for those who assess the class. Students see their grades in the panel after the class releases them. | |
nivelSupervisao | NivelSupervisao or null | no | Supervision level given by the last assessor; null = not provided. Only for assessors (students read it in the assessment after release). | |
relatoEditadoEm | string or null | no | Last edit of the account by the student; null = never edited. After avaliadaEm = edited after the assessment. |
On error: ErroApi model.
Example
bash
curl -X PUT "$API/me/atividades/{atividadeId}/presenca/relato" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -d '{"relato":"texto"}'Generate the activity QR for the student
GET /me/atividades/{atividadeId}/qr
Access: Any signed-in person. Rate limit: up to 600 calls every 60 s per origin. Success status: 200.
Path parameters
| Parameter | Type | Required | Constraints | Description |
|---|---|---|---|---|
atividadeId | string (uuid) | yes | Activity id. |
Response
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
token | string | yes | ||
expiraEm | string | yes |
On error: ErroApi model.
Example
bash
curl -X GET "$API/me/atividades/{atividadeId}/qr" -H "Authorization: Bearer $TOKEN"