Catálogo de actividades
Elementos del catálogo de actividades profesionales de una asignatura, usados para clasificar las actividades.
Lista el catálogo de actividades de la asignatura
GET /disciplinas/{disciplinaId}/atividades-profissionais
Acceso: Exige la capacidad LER sobre asignatura (params.disciplinaId). Estado de éxito: 200.
Parámetros de ruta
| Parámetro | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
disciplinaId | string (uuid) | sí | Id de la asignatura. |
Parámetros de consulta
| Parámetro | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
inativos | "true" | "false" | no | por defecto: "false" | true incluye también los registros inactivos. |
Respuesta
| Campo | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
items | lista de AtividadeProfissionalDto | sí |
En caso de error: modelo ErroApi.
Ejemplo
curl -X GET "$API/disciplinas/{disciplinaId}/atividades-profissionais" -H "Authorization: Bearer $TOKEN"Crea un elemento en el catálogo de la asignatura
POST /disciplinas/{disciplinaId}/atividades-profissionais
Acceso: Exige la capacidad CADASTRAR sobre asignatura (params.disciplinaId). Estado de éxito: 201.
Parámetros de ruta
| Parámetro | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
disciplinaId | string (uuid) | sí | Id de la asignatura. |
Cuerpo de la solicitud (AtividadeProfissionalCriar)
| Campo | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
nome | string | sí | 1–200 caracteres | |
descricao | string o nulo | no | a 2000 caracteres |
Respuesta
| Campo | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
id | string (uuid) | sí | ||
disciplinaId | string (uuid) | sí | ||
nome | string | sí | ||
descricao | string o nulo | sí | ||
ativo | boolean | sí | ||
atividades | integer | sí | Cuántas actividades (ocurrencias) apuntan al elemento. |
En caso de error: modelo ErroApi.
Ejemplo
curl -X POST "$API/disciplinas/{disciplinaId}/atividades-profissionais" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -d '{"nome":"texto"}'Actualiza un elemento del catálogo
PATCH /disciplinas/{disciplinaId}/atividades-profissionais/{itemId}
Acceso: Exige la capacidad CADASTRAR sobre asignatura (params.disciplinaId). Estado de éxito: 200.
Parámetros de ruta
| Parámetro | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
itemId | string (uuid) | sí | Id del elemento del catálogo de actividades. | |
disciplinaId | string (uuid) | sí | Id de la asignatura. |
Cuerpo de la solicitud (AtividadeProfissionalAtualizar)
| Campo | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
nome | string | no | 1–200 caracteres | |
descricao | string o nulo | no | a 2000 caracteres | |
ativo | boolean | no |
Respuesta
| Campo | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
id | string (uuid) | sí | ||
disciplinaId | string (uuid) | sí | ||
nome | string | sí | ||
descricao | string o nulo | sí | ||
ativo | boolean | sí | ||
atividades | integer | sí | Cuántas actividades (ocurrencias) apuntan al elemento. |
En caso de error: modelo ErroApi.
Ejemplo
curl -X PATCH "$API/disciplinas/{disciplinaId}/atividades-profissionais/{itemId}" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -d '{}'Fusiona un elemento del catálogo con otro
POST /disciplinas/{disciplinaId}/atividades-profissionais/{itemId}/mesclar
Acceso: Exige la capacidad CADASTRAR sobre asignatura (params.disciplinaId). Estado de éxito: 200.
Parámetros de ruta
| Parámetro | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
itemId | string (uuid) | sí | Id del elemento del catálogo de actividades. | |
disciplinaId | string (uuid) | sí | Id de la asignatura. |
Cuerpo de la solicitud (AtividadeProfissionalMesclar)
| Campo | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
destinoId | string (uuid) | sí |
Respuesta
| Campo | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
id | string (uuid) | sí | ||
disciplinaId | string (uuid) | sí | ||
nome | string | sí | ||
descricao | string o nulo | sí | ||
ativo | boolean | sí | ||
atividades | integer | sí | Cuántas actividades (ocurrencias) apuntan al elemento. |
En caso de error: modelo ErroApi.
Ejemplo
curl -X POST "$API/disciplinas/{disciplinaId}/atividades-profissionais/{itemId}/mesclar" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -d '{"destinoId":"0198a000-0000-7000-8000-000000000001"}'Catálogo de actividades de la asignatura del grupo
GET /turmas/{turmaId}/atividades-profissionais
Acceso: Exige la capacidad LER sobre grupo (params.turmaId). Estado de éxito: 200.
Parámetros de ruta
| Parámetro | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
turmaId | string (uuid) | sí | Id del grupo. |
Respuesta
| Campo | Tipo | Obligatorio | Restricciones | Descripción |
|---|---|---|---|---|
items | lista de AtividadeProfissionalDto | sí |
En caso de error: modelo ErroApi.
Ejemplo
curl -X GET "$API/turmas/{turmaId}/atividades-profissionais" -H "Authorization: Bearer $TOKEN"