Pular para o conteúdo principal

Cursos do instrutor

Os cursos que o instrutor está habilitado a ministrar. Correspondem à aba Cursos, na tela Instrutores. Os mesmos vínculos aparecem na aba Instrutores habilitados do cadastro do curso, no módulo Comercial.

Os cursos habilitados não filtram a lista de instrutores ao escolher o instrutor de uma turma.

Endpoints​

MétodoCaminhoDescrição
GET/administrative/instructors/{uuid}/coursesLista os cursos do instrutor
POST/administrative/instructors/{uuid}/coursesVincula um curso ao instrutor
GET/administrative/instructors/{uuid}/courses/{id}Consulta um vínculo
DELETE/administrative/instructors/{uuid}/courses/{id}Remove um curso da lista do instrutor
GET/administrative/instructors/coursesBusca cursos para vincular

O {uuid} é o uuid do instrutor. O {id} é o id numérico do vínculo.

Endpoints de cursos​

GET /administrative/instructors/{uuid}/courses​

Lista os cursos do instrutor.

Parâmetros de URL

ParâmetroDescrição
searchBusca pelo nome ou código do curso, ou pelo nome do grupo
columnName e orderDataOrdenação: coluna e direção
per_page e pagePaginação

Resposta: 200, lista de vínculos com id, customer_vendor_id, course_id, customer_vendor_name, course, course_code, workload (carga horária) e group (grupo do curso).

POST /administrative/instructors/{uuid}/courses​

Vincula um curso ao instrutor. Um curso não pode ser vinculado duas vezes ao mesmo instrutor. Se o vínculo já existir, a chamada devolve o vínculo existente. Se ele tiver sido removido antes, a chamada o restaura.

Corpo

CampoObrigatórioTipoDescrição
course_uuidSimTexto (uuid)Uuid do curso. Deve existir

Resposta: 200, com o vínculo criado ou restaurado.

{
"course_uuid": "<uuid-do-curso>"
}

GET /administrative/instructors/{uuid}/courses/{id}​

Consulta um vínculo, com os dados do instrutor e do curso.

Resposta: 200, com o vínculo.

DELETE /administrative/instructors/{uuid}/courses/{id}​

Remove o curso da lista do instrutor. A exclusão é lógica e não verifica turmas.

Resposta: 200, com success (true quando removido, false quando o vínculo não é encontrado) e message.

Busca de cursos​

GET /administrative/instructors/courses​

Busca os cursos do cliente, para escolher o curso que será vinculado ao instrutor. A busca aceita nome, código, nome curto ou grupo do curso.

Parâmetros de URL

ParâmetroDescrição
searchBusca pelo nome, código, uuid, nome curto ou nome do grupo do curso
group_uuidUuid do grupo do curso
per_page e pagePaginação

Resposta: 200, lista de cursos com o nome, o código, a carga horária e o nome curto de cada curso, entre outros dados do cadastro de cursos.