Componentes BNCC

A Base Nacional Comum Curricular (BNCC) define os componentes curriculares que podem ser associados às disciplinas de uma escola. Use este endpoint para obter os IDs de componente necessários ao criar ou editar disciplinas — o campo bncc_component_id nas disciplinas referencia diretamente um registro desta lista.

Os componentes BNCC são dados de referência globais — não são filtrados por escola ou cliente. Esta rota retorna todos os componentes cadastrados no sistema, ordenados por sort_order. Para verificar como vincular um componente a uma disciplina, consulte Disciplinas.

O modelo componente BNCC

id uuid

Identificador único do componente.

code string

Código curto do componente (ex: LP, MA, CN). Único por combinação code+stage.

name string

Nome completo do componente curricular (ex: Língua Portuguesa).

area string|null

Área do conhecimento à qual o componente pertence (ex: Linguagens).

stage string

Etapa de ensino: EF (Ensino Fundamental), EM (Ensino Médio) ou EI (Educação Infantil).

sort_order integer

Ordem de exibição do componente na listagem.

Valores possíveis para stage

EF

Ensino Fundamental (Anos Iniciais e Finais)

EM

Ensino Médio

EI

Educação Infantil

Modelo componente BNCC
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "code": "LP",
  "name": "Língua Portuguesa",
  "area": "Linguagens",
  "stage": "EF",
  "sort_order": 10
}
GET /v1/partners/bncc-components/all

Listar componentes BNCC

Retorna todos os componentes curriculares da BNCC disponíveis no sistema, ordenados por sort_order. Use os id retornados para preencher o campo bncc_component_id ao criar ou editar disciplinas. Esta rota não é filtrada por escola — é uma lista global de referência.

Códigos de resposta

200

Sucesso.

401

Autenticação inválida.

Requisição GET
GET /v1/partners/bncc-components/all
curl https://toakiescola.com.br/api/v1/partners/bncc-components/all \
  -H "X-Authorization: {api_token}" \
  -H "X-Partner: {partner_token}" \
  -H "X-Client: {client_slug}"
Resposta 
{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "code": "LP",
      "name": "Língua Portuguesa",
      "area": "Linguagens",
      "stage": "EF",
      "sort_order": 10
    },
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "code": "MA",
      "name": "Matemática",
      "area": "Matemática",
      "stage": "EF",
      "sort_order": 20
    }
  ]
}