> ## Documentation Index
> Fetch the complete documentation index at: https://docs.followw.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Buscar turmas no SIGAA

> Consulta as ofertas diretamente no SIGAA, em todos os níveis de ensino.



## OpenAPI

````yaml /mintlify/openapi.json get /public/classrooms
openapi: 3.1.0
info:
  title: Followw UnB API
  description: >-
    API independente e open-source para consultar dados do SIGAA e de outros
    sistemas da UnB. O acesso autenticado usa a conta do SIGAA, com sessão por
    cookies.
  version: 0.1.0
servers:
  - url: https://api.followw.app
    description: Produção
  - url: http://localhost:8000
    description: Desenvolvimento local
security: []
tags:
  - name: Auth
    description: Login no SIGAA e sessão por cookies.
  - name: Classrooms
    description: Turmas, participantes, frequência e resultados acadêmicos.
  - name: Me
    description: Perfil, configurações, documentos e acesso ao RU.
  - name: Public Classrooms
    description: Turmas e unidades do SIGAA.
    x-displayName: Classrooms
  - name: Public Courses
    description: Cursos e currículos por ingresso.
    x-displayName: Courses
  - name: Public Professors
    description: Catálogo de docentes.
    x-displayName: Professors
  - name: Public Restaurant
    description: Cardápio do RU.
    x-displayName: Restaurant
  - name: Public Search
    description: Busca de matérias, cursos e docentes.
    x-displayName: Search
  - name: Public Subjects
    description: Matérias de graduação e suas turmas.
    x-displayName: Subjects
  - name: Posts
    description: Notícias e avaliações das turmas.
paths:
  /public/classrooms:
    get:
      tags:
        - Public Classrooms
      summary: Buscar turmas no SIGAA
      description: Consulta as ofertas diretamente no SIGAA, em todos os níveis de ensino.
      operationId: search_classrooms_public_classrooms_get
      parameters:
        - name: unit
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                maximum: 2147483647
                exclusiveMinimum: 0
              - type: string
                pattern: '[^0-9]'
              - type: 'null'
            description: >-
              ID ou sigla da unidade; obrigatório sem `code`. Consulte
              /public/classrooms/units.
            title: Unit
          description: >-
            ID ou sigla da unidade; obrigatório sem `code`. Consulte
            /public/classrooms/units.
        - name: semester
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                pattern: ^[0-9]{4}\.[0-9]$
              - type: 'null'
            description: Semestre da oferta.
            title: Semester
          description: Semestre da oferta.
        - name: q
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Trecho do nome ou código da matéria, ou do nome do docente.
            title: Q
          description: Trecho do nome ou código da matéria, ou do nome do docente.
        - name: local
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Trecho do local da turma, incluindo unidade e sala.
            title: Local
          description: Trecho do local da turma, incluindo unidade e sala.
        - name: code
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                pattern: ^\s*[A-Za-z]+[0-9]+\s*$
              - type: 'null'
            description: Código completo da matéria; obrigatório sem `unit`.
            title: Code
          description: Código completo da matéria; obrigatório sem `unit`.
        - name: number
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                maximum: 99
                minimum: 1
              - type: 'null'
            description: Número da turma.
            title: Number
          description: Número da turma.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/PublicClassroom'
                title: Response Search Classrooms Public Classrooms Get
        '404':
          description: Nenhuma oferta encontrada nas unidades e no semestre consultados.
        '422':
          description: Filtros inválidos ou unidade não identificada.
        '502':
          description: SIGAA indisponível ou resposta ilegível.
components:
  schemas:
    PublicClassroom:
      properties:
        number:
          type: string
          title: Number
        semester:
          type: string
          title: Semester
        schedule:
          anyOf:
            - type: string
            - type: 'null'
          title: Schedule
        schedule_description:
          anyOf:
            - type: string
            - type: 'null'
          title: Schedule Description
        room:
          anyOf:
            - type: string
            - type: 'null'
          title: Room
        vacancies:
          anyOf:
            - type: integer
            - type: 'null'
          title: Vacancies
        occupied:
          anyOf:
            - type: integer
            - type: 'null'
          title: Occupied
        professors:
          items:
            type: string
          type: array
          title: Professors
          default: []
        subject:
          $ref: '#/components/schemas/Subject'
      type: object
      required:
        - number
        - semester
        - subject
      title: PublicClassroom
      description: Turma pública, identificada por `(subject.code, number, semester)`.
    Subject:
      properties:
        code:
          anyOf:
            - type: string
            - type: 'null'
          title: Code
        sigaa_id:
          anyOf:
            - type: integer
            - type: 'null'
          title: Sigaa Id
        name:
          type: string
          title: Name
        hours:
          anyOf:
            - type: integer
            - type: 'null'
          title: Hours
        unit:
          anyOf:
            - type: string
            - type: 'null'
          title: Unit
      type: object
      required:
        - name
      title: Subject
      description: Componente curricular.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.