Buscar matérias com suas turmas

Consulta os componentes e turmas gravados no Followw, sem ir ao SIGAA; os filtros se combinam. Cada componente traz as turmas do semestre consultado, vazias se não houver oferta. Sem q, code e unit, um aluno de graduação logado recebe as recomendações para o próximo semestre, ordenadas e com recommendation; visitantes precisam informar um filtro.

GET /public/subjects

Buscar matérias com suas turmas

cURL

curl --request GET \
  --url https://api.followw.app/public/subjects

200

[
  {
    "code": "<string>",
    "name": "<string>",
    "classrooms": [
      {
        "number": "<string>",
        "semester": "<string>",
        "professors": [],
        "vacancies": 123,
        "occupied": 123,
        "sigaa_id": 123,
        "schedule": "<string>",
        "room": "<string>"
      }
    ],
    "hours": 123,
    "unit": {
      "id": 123,
      "code": "<string>",
      "name": "<string>"
    },
    "prerequisites": [
      [
        {
          "code": "<string>",
          "subject": {
            "code": "<string>",
            "name": "<string>"
          }
        }
      ]
    ],
    "corequisites": [
      [
        {
          "code": "<string>",
          "subject": {
            "code": "<string>",
            "name": "<string>"
          }
        }
      ]
    ],
    "equivalences": [
      [
        {
          "code": "<string>",
          "subject": {
            "code": "<string>",
            "name": "<string>"
          }
        }
      ]
    ],
    "curriculum_prerequisites": [
      [
        {
          "code": "<string>",
          "subject": {
            "code": "<string>",
            "name": "<string>"
          }
        }
      ]
    ],
    "curriculum_corequisites": [
      [
        {
          "code": "<string>",
          "subject": {
            "code": "<string>",
            "name": "<string>"
          }
        }
      ]
    ],
    "offered_equivalences": [
      [
        {
          "code": "<string>",
          "subject": {
            "code": "<string>",
            "name": "<string>"
          }
        }
      ]
    ],
    "kind": "mandatory",
    "unlocks": [
      {
        "code": "<string>",
        "name": "<string>"
      }
    ],
    "curriculum_period": 123,
    "recommendation": {
      "reasons": [
        {
          "code": "required",
          "value": 123
        }
      ]
    }
  }
]

Headers

Cache-Control · string | null

no-cache (ou max-age=0) busca na origem antes de responder; max-age=N aceita cache de até N s; stale-if-error[=N] devolve o cache se a origem falhar; only-if-cached nunca busca (504 sem cache).

Query Parameters

q · string | null

Trecho do código, nome do componente ou docente, de 3 a 32 caracteres, ignorando acentos, maiúsculas e espaços extras.

Required string length: 3 - 32

Pattern: \S

code · string | null

Código completo do componente, como FGA0003.

Pattern: ^\s*[A-Za-z]+[0-9]+\s*$

unit · integer string

ID ou código exato da unidade responsável, como 673 ou FCTE.

Required range: 0 < x <= 2147483647

semester · string | null

Semestre das turmas, no formato AAAA.P. Sem ele, usa o mais recente gravado.

Pattern: ^[0-9]{4}\.[0-9]$

Response

200

application/json

Successful Response

code · string · required

name · string · required

classrooms · SubjectClassroom · object[] · required

Show child attributes

hours · integer | null

unit · UnitRef · object | null

Unidade acadêmica: id do SIGAA, code a sigla (ex.: FCTE).

Show child attributes

prerequisites · SubjectRequirement · object[][] | null

Show child attributes

corequisites · SubjectRequirement · object[][] | null

Show child attributes

equivalences · SubjectRequirement · object[][] | null

Show child attributes

curriculum_prerequisites · SubjectRequirement · object[][] | null

Show child attributes

curriculum_corequisites · SubjectRequirement · object[][] | null

Show child attributes

offered_equivalences · SubjectRequirement · object[][] | null

Show child attributes

kind · enum<string> | null

Available options: mandatory, optional, free

unlocks · SubjectReference · object[]

Show child attributes

curriculum_period · integer | null

recommendation · SubjectRecommendation · object | null

Motivos da posição no ranking, do mais ao menos relevante.

Show child attributes