Criterios de evaluación

Criterios (y rúbricas) que la asignatura usa para poner notas.

Lista los criterios de evaluación de la asignatura

GET /disciplinas/{disciplinaId}/criterios

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

Criterios

Campo	Tipo	Obligatorio	Restricciones	Descripción
`items`	lista de CriterioDto	sí

En caso de error: modelo ErroApi.

Ejemplo

bash

curl -X GET "$API/disciplinas/{disciplinaId}/criterios" -H "Authorization: Bearer $TOKEN"

Crea un criterio de evaluación

POST /disciplinas/{disciplinaId}/criterios

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 (CriterioCriar)

Campo	Tipo	Obligatorio	Restricciones
`chave`	`string`	sí	`^[a-z][a-z0-9_]{1,39}$`
`notaMin`	`integer`	sí	0…99
`notaMax`	`integer`	sí	1…100
`permiteNa`	`boolean`	no	por defecto: `false`
`ordem`	`integer`	no	0…999
`nomes`	CriterioNomes	sí
`descricoes`	CriterioDescricoes	no
`rubricas`	CriterioRubricas	no

Respuesta

CriterioDto

Campo	Tipo	Obligatorio	Descripción
`id`	`string (uuid)`	sí
`disciplinaId`	`string (uuid)`	sí
`chave`	`string`	sí
`notaMin`	`integer`	sí
`notaMax`	`integer`	sí
`permiteNa`	`boolean`	sí
`ordem`	`integer`	sí
`ativo`	`boolean`	sí
`nome`	`string`	sí	Nombre en el idioma de quien pidió (cae en portugués y luego en cualquier idioma).
`nomes`	`object`	sí	Todos los nombres registrados, por idioma (para editar).
`descricao`	`string`	sí	Descripción de cómo evaluar en el idioma de quien pidió (cae en portugués; vacía si no hay).
`descricoes`	`object`	sí	Todas las descripciones registradas, por idioma (para editar).
`rubrica`	Rubrica	sí	Rúbrica en el idioma de quien pidió (cae en portugués; vacía si no hay).
`rubricas`	`object`	sí	Todas las rúbricas registradas, por idioma (para editar).

En caso de error: modelo ErroApi.

Ejemplo

bash

curl -X POST "$API/disciplinas/{disciplinaId}/criterios" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -d '{"chave":"texto","notaMin":0,"notaMax":1,"nomes":{"pt-BR":"texto"}}'

Actualiza un criterio de evaluación

PATCH /disciplinas/{disciplinaId}/criterios/{criterioId}

Acceso: Exige la capacidad CADASTRAR sobre asignatura (params.disciplinaId). Estado de éxito: 200.

Parámetros de ruta

Parámetro	Tipo	Obligatorio	Restricciones	Descripción
`criterioId`	`string (uuid)`	sí		Id del criterio de evaluación.
`disciplinaId`	`string (uuid)`	sí		Id de la asignatura.

Cuerpo de la solicitud (CriterioAtualizar)

Campo	Tipo	Obligatorio	Restricciones
`nomes`	`object`	no
`nomes.pt-BR`	`string`	no	1–120 caracteres
`nomes.es`	`string`	no	1–120 caracteres
`nomes.en-US`	`string`	no	1–120 caracteres
`descricoes`	CriterioDescricoes	no
`rubricas`	CriterioRubricas	no
`ordem`	`integer`	no	0…999
`ativo`	`boolean`	no

Respuesta

CriterioDto

Campo	Tipo	Obligatorio	Descripción
`id`	`string (uuid)`	sí
`disciplinaId`	`string (uuid)`	sí
`chave`	`string`	sí
`notaMin`	`integer`	sí
`notaMax`	`integer`	sí
`permiteNa`	`boolean`	sí
`ordem`	`integer`	sí
`ativo`	`boolean`	sí
`nome`	`string`	sí	Nombre en el idioma de quien pidió (cae en portugués y luego en cualquier idioma).
`nomes`	`object`	sí	Todos los nombres registrados, por idioma (para editar).
`descricao`	`string`	sí	Descripción de cómo evaluar en el idioma de quien pidió (cae en portugués; vacía si no hay).
`descricoes`	`object`	sí	Todas las descripciones registradas, por idioma (para editar).
`rubrica`	Rubrica	sí	Rúbrica en el idioma de quien pidió (cae en portugués; vacía si no hay).
`rubricas`	`object`	sí	Todas las rúbricas registradas, por idioma (para editar).

En caso de error: modelo ErroApi.

Ejemplo

bash

curl -X PATCH "$API/disciplinas/{disciplinaId}/criterios/{criterioId}" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -d '{}'