Especialização do instrutor
As qualificações profissionais do instrutor, com o número do registro ou do documento que as comprova. Correspondem à aba Especialização, na tela Instrutores. A API não gera alerta de vencimento.
Use o uuid do instrutor nos caminhos abaixo.
Endpoints
| Método | Caminho | Descrição |
|---|---|---|
| GET | /administrative/instructors/{uuid}/specializations | Lista as especializações do instrutor |
| POST | /administrative/instructors/{uuid}/specializations | Cadastra uma especialização |
| GET | /administrative/instructors/{uuid}/specializations/{id} | Consulta uma especialização |
| PUT | /administrative/instructors/{uuid}/specializations/{id} | Altera uma especialização |
| DELETE | /administrative/instructors/{uuid}/specializations/{id} | Apaga uma especialização |
O {id} é o id numérico da especialização.
Endpoints de especialização
GET /administrative/instructors/{uuid}/specializations
Lista as especializações do instrutor.
Parâmetros de URL
| Parâmetro | Descrição |
|---|---|
| search | Busca pela especialização, pelo número do documento, pelas datas e pelo nome do instrutor |
| column e order | Ordenação: coluna e direção (asc ou desc) |
| per_page e page | Paginação |
Resposta: 200, lista com id, employee_id, employee_name, specialization,
document_number, completion_date, expiration_date e os nomes de quem criou e
alterou o registro.
POST /administrative/instructors/{uuid}/specializations
Cadastra uma especialização para o instrutor.
Corpo
| Campo | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| specialization | Sim | Texto | Nome da qualificação |
| document_number | Sim | Texto | Número do registro ou do documento que comprova a qualificação |
| completion_date | Não | Data (AAAA-MM-DD) | Data de conclusão |
| expiration_date | Não | Data (AAAA-MM-DD) | Data de vencimento. É apenas informativa |
Resposta: 200, com a especialização criada.
GET /administrative/instructors/{uuid}/specializations/{id} e DELETE /administrative/instructors/{uuid}/specializations/{id}
Consultar e apagar uma especialização. A exclusão é lógica.
Resposta: 200.
PUT /administrative/instructors/{uuid}/specializations/{id}
Altera uma especialização. Envie somente os campos que mudam. Os campos são os mesmos da criação, e nenhum é obrigatório nesta chamada.
Resposta: 200, com a especialização alterada.