Asistencia (alumno)
Lo que hace el alumno: pedir asistencia, editar el relato y generar el QR de la actividad.
Pide la asistencia en una actividad
POST /me/atividades/{atividadeId}/presenca
Acceso: Cualquier persona autenticada. Límite: hasta 600 llamadas cada 60 s por origen. Estado de éxito: 201.
Parámetros de ruta
| Parámetro | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
atividadeId | string (uuid) | sí | Id de la actividad. |
Cuerpo de la solicitud (PresencaSolicitar)
| Campo | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
relato | string | no | a 2000 caracteres | Hasta 2000 caracteres. |
justificativa | string | no | a 2000 caracteres | Obligatoria cuando el pedido cae en excepción. |
clienteId | string (uuid) | no | Generado en el aparato: reenviar la cola sin conexión no duplica. | |
capturadaEm | string (date-time) | no | Instante en que el aparato capturó el pedido (cola sin conexión). | |
lat | number | no | -90…90 | |
lng | number | no | -180…180 | |
precisaoM | integer | no | 0…1000000 |
Respuesta
| Campo | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
id | string (uuid) | sí | ||
atividadeId | string (uuid) | sí | ||
matriculaId | string (uuid) | sí | ||
estado | "SOLICITADA" | "CONFIRMADA" | "REJEITADA" | sí | ||
solicitadaEm | string | sí | ||
capturadaEm | string o nulo | sí | ||
relato | string o nulo | sí | ||
justificativa | string o nulo | sí | ||
excecoes | lista de "FORA_DA_JANELA" | "FORA_DA_CERCA" | "OUTRO_DIA" | sí | ||
avaliadaEm | string o nulo | sí | ||
comentarioAvaliador | string o nulo | sí | ||
notas | lista de Nota | sí | Solo para quien evalúa el grupo. El alumno ve sus notas en el panel, después de que el grupo las libera. | |
nivelSupervisao | NivelSupervisao o nulo | no | Nivel de supervisión dado por el último evaluador; nulo = no informado. Solo para quien evalúa (el alumno lo lee en la evaluación, tras la liberación). | |
relatoEditadoEm | string o nulo | no | Última edición del relato por el alumno; nulo = nunca editado. Posterior a avaliadaEm = editado después de la evaluación. |
En caso de error: modelo ErroApi.
Ejemplo
curl -X POST "$API/me/atividades/{atividadeId}/presenca" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -d '{}'Edita el relato de la propia asistencia
PUT /me/atividades/{atividadeId}/presenca/relato
Acceso: Cualquier persona autenticada. Límite: hasta 600 llamadas cada 60 s por origen. Estado de éxito: 200.
Parámetros de ruta
| Parámetro | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
atividadeId | string (uuid) | sí | Id de la actividad. |
Cuerpo de la solicitud (RelatoEditar)
| Campo | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
relato | string | sí | a 2000 caracteres |
Respuesta
| Campo | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
id | string (uuid) | sí | ||
atividadeId | string (uuid) | sí | ||
matriculaId | string (uuid) | sí | ||
estado | "SOLICITADA" | "CONFIRMADA" | "REJEITADA" | sí | ||
solicitadaEm | string | sí | ||
capturadaEm | string o nulo | sí | ||
relato | string o nulo | sí | ||
justificativa | string o nulo | sí | ||
excecoes | lista de "FORA_DA_JANELA" | "FORA_DA_CERCA" | "OUTRO_DIA" | sí | ||
avaliadaEm | string o nulo | sí | ||
comentarioAvaliador | string o nulo | sí | ||
notas | lista de Nota | sí | Solo para quien evalúa el grupo. El alumno ve sus notas en el panel, después de que el grupo las libera. | |
nivelSupervisao | NivelSupervisao o nulo | no | Nivel de supervisión dado por el último evaluador; nulo = no informado. Solo para quien evalúa (el alumno lo lee en la evaluación, tras la liberación). | |
relatoEditadoEm | string o nulo | no | Última edición del relato por el alumno; nulo = nunca editado. Posterior a avaliadaEm = editado después de la evaluación. |
En caso de error: modelo ErroApi.
Ejemplo
curl -X PUT "$API/me/atividades/{atividadeId}/presenca/relato" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -d '{"relato":"texto"}'Genera el QR de la actividad para el alumno
GET /me/atividades/{atividadeId}/qr
Acceso: Cualquier persona autenticada. Límite: hasta 600 llamadas cada 60 s por origen. Estado de éxito: 200.
Parámetros de ruta
| Parámetro | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
atividadeId | string (uuid) | sí | Id de la actividad. |
Respuesta
| Campo | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
token | string | sí | ||
expiraEm | string | sí |
En caso de error: modelo ErroApi.
Ejemplo
curl -X GET "$API/me/atividades/{atividadeId}/qr" -H "Authorization: Bearer $TOKEN"