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étodo | Caminho | Descrição |
|---|---|---|
| GET | /administrative/instructors/{uuid}/courses | Lista os cursos do instrutor |
| POST | /administrative/instructors/{uuid}/courses | Vincula 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/courses | Busca 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âmetro | Descrição |
|---|---|
| search | Busca pelo nome ou código do curso, ou pelo nome do grupo |
| columnName e orderData | Ordenação: coluna e direção |
| per_page e page | Paginaçã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
| Campo | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| course_uuid | Sim | Texto (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âmetro | Descrição |
|---|---|
| search | Busca pelo nome, código, uuid, nome curto ou nome do grupo do curso |
| group_uuid | Uuid do grupo do curso |
| per_page e page | Paginaçã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.