Critérios de avaliação

Critérios (e rubricas) que a disciplina usa para dar notas.

Lista os critérios de avaliação da disciplina

GET /disciplinas/{disciplinaId}/criterios

Acesso: Exige a capacidade LER sobre disciplina (params.disciplinaId). Status de sucesso: 200.

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Restrições	Descrição
`disciplinaId`	`string (uuid)`	sim		Id da disciplina.

Parâmetros de consulta

Parâmetro	Tipo	Obrigatório	Restrições	Descrição
`inativos`	`"true"` \| `"false"`	não	padrão: `"false"`	`true` inclui também os registros inativos.

Resposta

Criterios

Campo	Tipo	Obrigatório	Restrições	Descrição
`items`	lista de CriterioDto	sim

Em caso de erro: modelo ErroApi.

Exemplo

bash

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

Cria um critério de avaliação

POST /disciplinas/{disciplinaId}/criterios

Acesso: Exige a capacidade CADASTRAR sobre disciplina (params.disciplinaId). Status de sucesso: 201.

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Restrições	Descrição
`disciplinaId`	`string (uuid)`	sim		Id da disciplina.

Corpo da requisição (CriterioCriar)

Campo	Tipo	Obrigatório	Restrições
`chave`	`string`	sim	`^[a-z][a-z0-9_]{1,39}$`
`notaMin`	`integer`	sim	0…99
`notaMax`	`integer`	sim	1…100
`permiteNa`	`boolean`	não	padrão: `false`
`ordem`	`integer`	não	0…999
`nomes`	CriterioNomes	sim
`descricoes`	CriterioDescricoes	não
`rubricas`	CriterioRubricas	não

Resposta

CriterioDto

Campo	Tipo	Obrigatório	Descrição
`id`	`string (uuid)`	sim
`disciplinaId`	`string (uuid)`	sim
`chave`	`string`	sim
`notaMin`	`integer`	sim
`notaMax`	`integer`	sim
`permiteNa`	`boolean`	sim
`ordem`	`integer`	sim
`ativo`	`boolean`	sim
`nome`	`string`	sim	Nome no idioma de quem pediu (cai no português e depois em qualquer idioma).
`nomes`	`object`	sim	Todos os nomes cadastrados, por idioma (para editar).
`descricao`	`string`	sim	Descrição de como avaliar no idioma de quem pediu (cai no português; vazia se não houver).
`descricoes`	`object`	sim	Todas as descrições cadastradas, por idioma (para editar).
`rubrica`	Rubrica	sim	Rubrica no idioma de quem pediu (cai no português; vazia se não houver).
`rubricas`	`object`	sim	Todas as rubricas cadastradas, por idioma (para editar).

Em caso de erro: modelo ErroApi.

Exemplo

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"}}'

Atualiza um critério de avaliação

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

Acesso: Exige a capacidade CADASTRAR sobre disciplina (params.disciplinaId). Status de sucesso: 200.

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Restrições	Descrição
`criterioId`	`string (uuid)`	sim		Id do critério de avaliação.
`disciplinaId`	`string (uuid)`	sim		Id da disciplina.

Corpo da requisição (CriterioAtualizar)

Campo	Tipo	Obrigatório	Restrições
`nomes`	`object`	não
`nomes.pt-BR`	`string`	não	1–120 caracteres
`nomes.es`	`string`	não	1–120 caracteres
`nomes.en-US`	`string`	não	1–120 caracteres
`descricoes`	CriterioDescricoes	não
`rubricas`	CriterioRubricas	não
`ordem`	`integer`	não	0…999
`ativo`	`boolean`	não

Resposta

CriterioDto

Campo	Tipo	Obrigatório	Descrição
`id`	`string (uuid)`	sim
`disciplinaId`	`string (uuid)`	sim
`chave`	`string`	sim
`notaMin`	`integer`	sim
`notaMax`	`integer`	sim
`permiteNa`	`boolean`	sim
`ordem`	`integer`	sim
`ativo`	`boolean`	sim
`nome`	`string`	sim	Nome no idioma de quem pediu (cai no português e depois em qualquer idioma).
`nomes`	`object`	sim	Todos os nomes cadastrados, por idioma (para editar).
`descricao`	`string`	sim	Descrição de como avaliar no idioma de quem pediu (cai no português; vazia se não houver).
`descricoes`	`object`	sim	Todas as descrições cadastradas, por idioma (para editar).
`rubrica`	Rubrica	sim	Rubrica no idioma de quem pediu (cai no português; vazia se não houver).
`rubricas`	`object`	sim	Todas as rubricas cadastradas, por idioma (para editar).

Em caso de erro: modelo ErroApi.

Exemplo

bash

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