POST
/
api
/
v1
/
schools
/
{schoolId}
/
classrooms
curl --request POST \
  --url https://trialprod.app.toolzz.com.br/api/v1/schools/{schoolId}/classrooms \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "schoolId": 123,
  "type": {},
  "code": "<string>",
  "title": "<string>",
  "groups": [
    {}
  ],
  "subgroups": [
    {}
  ],
  "specialties": [
    {}
  ],
  "contents": [
    {}
  ],
  "registration_start_date": "<string>",
  "registration_end_date": "<string>"
}'
{
  "success": true,
  "data": {
    "id": 123,
    "schoolId": "<string>",
    "title": "<string>",
    "code": "<string>",
    "image": "<string>",
    "course": "<string>",
    "groups": [
      {
        "id": 123,
        "name": "<string>"
      }
    ],
    "subgroups": [
      {
        "id": 123,
        "name": "<string>"
      }
    ],
    "specialties": [
      {
        "id": 123,
        "name": "<string>"
      }
    ],
    "trails": [
      {}
    ],
    "contents": [
      {}
    ],
    "createdAt": "<string>",
    "updatedAt": "<string>"
  }
}

Parâmetros

schoolId
int

O identificador da escola à qual a turma será associada. FILTER ou EXCLUSIVE_CONTENT

type
enum
required

O tipo de turma a ser estabelecida, que pode ser baseada na filtragem de grupos, subgrupos e especialidades.

code
string
required

Código da turma: identificador único com 1 a 10 caracteres.

title
string
required

Título da turma: descrição em formato string com até 255 caracteres.

groups
array

Grupos: conjunto de identificadores dos grupos relacionados à turma. Obrigatório se o parâmetro type for FILTER.

subgroups
array

Subgrupos: conjunto de identificadores dos subgrupos associados à turma. Obrigatório se o parâmetro type for FILTER.

specialties
array

Especialidades: conjunto de identificadores das especialidades vinculadas à turma. Obrigatório se o parâmetro type for FILTER.

contents
array

Conteúdos exclusivos. Obrigatório quando o parâmetro type for EXCLUSIVE_CONTENT.

registration_start_date
string

Data de início das inscrições.

registration_end_date
string

Data de término das inscrições.

Descrição da Resposta

Abaixo está um exemplo da resposta retornada por este endpoint.

success
boolean

Indica se a requisição foi bem-sucedida.

data
object

Detalhes da turma criada.

Segurança

Para acessar este endpoint, é necessário enviar um token de acesso válido através do cabeçalho de autorização (Authorization) da requisição. Além disso, a API é protegida por outras medidas de segurança para garantir a proteção dos dados dos usuários.