Pular para o conteúdo principal

Datas da turma

Os dias em que a turma acontece. Na tela, ficam na aba Turmas > Datas de treinamento da página da turma. Cada data tem o dia da aula e a marcação de aula noturna. A data de início e a data de término da turma acompanham a menor e a maior data cadastradas.

Nas rotas desta página, {class_uuid} é o uuid da turma e {id} é o identificador numérico da data.

Endpoints​

MétodoCaminhoDescrição
GET/comercial/classes/{class_uuid}/datesLista as datas da turma
POST/comercial/classes/{class_uuid}/datesInclui uma data na turma
GET/comercial/classes/{class_uuid}/dates/{id}Consulta uma data da turma
PUT/comercial/classes/{class_uuid}/dates/{id}Altera uma data da turma
DELETE/comercial/classes/{class_uuid}/dates/{id}Remove uma data da turma

Listar e incluir​

GET /comercial/classes/{class_uuid}/dates​

Lista as datas da turma informada na URL, em ordem de data.

Parâmetros de URL

ParâmetroDescrição
column e orderOrdena pela coluna informada, em asc ou desc
per_page e pagePaginação. Sem per_page, a resposta é a lista completa

Resposta: 200. Cada item traz id, class_id, date, is_night e os nomes de quem criou e alterou o registro.

POST /comercial/classes/{class_uuid}/dates​

Inclui uma data na turma.

Corpo

CampoObrigatórioTipoDescrição
dateSimDataDia da aula. Não pode repetir uma data já cadastrada na mesma turma
is_nightNãoBooleanoMarca a aula como noturna

Efeitos:

  • Se a mesma data já foi apagada nesta turma, o registro é reativado e atualizado, em vez de criar outro.
  • A data de início e a data de término da turma são recalculadas a partir da menor e da maior data cadastradas.
curl -X POST "https://api.pedagogo.app/comercial/classes/<uuid-da-turma>/dates" \
-H "Authorization: Bearer <token-de-sessao>" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{"date": "2026-03-10", "is_night": false}'

Resposta: 200 com a data criada.

Consultar, alterar e apagar​

GET /comercial/classes/{class_uuid}/dates/{id}​

Consulta uma data da turma.

Resposta: 200 com a data. A data precisa pertencer a uma turma da empresa cliente.

PUT /comercial/classes/{class_uuid}/dates/{id}​

Altera uma data da turma.

Corpo

CampoObrigatórioTipoDescrição
dateNãoDataNovo dia da aula. Não pode repetir outra data da mesma turma
is_nightNãoBooleanoMarca ou desmarca a aula como noturna

Efeitos: as datas de início e de término da turma são recalculadas, como na inclusão.

Resposta: 200 com a data alterada.

DELETE /comercial/classes/{class_uuid}/dates/{id}​

Remove uma data da turma. A remoção é lógica, e as datas de início e de término da turma são recalculadas com as datas que restaram. Se era a última data cadastrada, as datas da turma ficam com o último valor calculado e voltam a ser editáveis no cadastro da turma.

Resposta: 200, com corpo null.