> ## 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 docentes do catálogo público

> Lista docentes coletados do SIGAA, sem login. Nome, unidade e semestre se combinam. O semestre seleciona docentes que ministraram uma disciplina de graduação naquele período.



## OpenAPI

````yaml /mintlify/openapi.json get /public/professors
openapi: 3.1.0
info:
  title: Followw UnB API
  description: >-
    Cliente alternativo e open-source para o ecossistema de sistemas da
    Universidade de Brasília (UnB). Agrega em uma experiência unificada e
    performática dados do SIGAA, Restaurante Universitário (RU) e calendário
    oficial, com autenticação stateless delegada ao CAS da UnB, credenciais
    cifradas em cookies JWE (AES-256-GCM), sincronização assíncrona inteligente
    e cache resiliente via Stale-While-Revalidate.
  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: >-
      Autenticação via SIGAA/CAS da UnB e gerenciamento de sessão stateless por
      cookies.
  - name: Classrooms
    description: >-
      Turmas do semestre e histórico, participantes, frequência e estatísticas
      de aprovação.
  - name: Me
    description: >-
      Perfil acadêmico, extrato/saldo do RU e carteirinha do estudante
      autenticado.
  - name: Public Classrooms
    description: Busca pública de turmas e unidades do SIGAA, sem autenticação.
    x-displayName: Classrooms
  - name: Public Courses
    description: >-
      Cursos cadastrados e seus currículos por semestre de ingresso, sem
      autenticação.
    x-displayName: Courses
  - name: Public Professors
    description: Catálogo público de docentes do SIGAA, sem autenticação.
    x-displayName: Professors
  - name: Public Restaurant
    description: Cardápio público do RU, sem autenticação.
    x-displayName: Restaurant
  - name: Public Subjects
    description: Componentes curriculares de graduação e suas turmas, sem autenticação.
    x-displayName: Subjects
  - name: Posts
    description: >-
      Notícias e avaliações recentes das turmas, consultadas diretamente na home
      do SIGAA.
paths:
  /public/professors:
    get:
      tags:
        - Public Professors
      summary: Buscar docentes do catálogo público
      description: >-
        Lista docentes coletados do SIGAA, sem login. Nome, unidade e semestre
        se combinam. O semestre seleciona docentes que ministraram uma
        disciplina de graduação naquele período.
      operationId: list_professors_public_professors_get
      parameters:
        - name: q
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                minLength: 4
                maxLength: 100
                pattern: ^[^\x00-\x1f\x7f]+$
              - type: 'null'
            description: Trecho do nome, com ao menos 4 caracteres; ignora acentos e caixa.
            title: Q
          description: Trecho do nome, com ao menos 4 caracteres; ignora acentos e caixa.
        - name: unit
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                maximum: 2147483647
                exclusiveMinimum: 0
              - type: string
                pattern: '[^0-9]'
              - type: 'null'
            description: ID ou código exato da unidade, como 673 ou FCTE.
            title: Unit
          description: ID ou código exato da unidade, como 673 ou FCTE.
        - name: semester
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                pattern: ^[0-9]{4}(?:\.[0-9])?$
              - type: 'null'
            description: >-
              Período de graduação, como 2026.2; registros antigos podem vir só
              com o ano.
            title: Semester
          description: >-
            Período de graduação, como 2026.2; registros antigos podem vir só
            com o ano.
        - name: page
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            default: 1
            title: Page
        - name: page_size
          in: query
          required: false
          schema:
            type: integer
            maximum: 100
            minimum: 1
            default: 50
            title: Page Size
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProfessorPage'
        '422':
          description: Filtro inválido ou unidade inexistente.
components:
  schemas:
    ProfessorPage:
      properties:
        items:
          items:
            $ref: '#/components/schemas/ProfessorItem'
          type: array
          title: Items
        total:
          type: integer
          title: Total
        page:
          type: integer
          title: Page
        page_size:
          type: integer
          title: Page Size
      type: object
      required:
        - items
        - total
        - page
        - page_size
      title: ProfessorPage
    ProfessorItem:
      properties:
        siape:
          type: integer
          title: Siape
        name:
          type: string
          title: Name
        unit:
          $ref: '#/components/schemas/UnitRef'
        photo:
          anyOf:
            - type: string
            - type: 'null'
          title: Photo
        url:
          type: string
          title: Url
      type: object
      required:
        - siape
        - name
        - unit
        - photo
        - url
      title: ProfessorItem
    UnitRef:
      properties:
        id:
          type: integer
          title: Id
        code:
          anyOf:
            - type: string
            - type: 'null'
          title: Code
        name:
          type: string
          title: Name
      type: object
      required:
        - id
        - code
        - name
      title: UnitRef
      description: 'Unidade acadêmica: `id` do SIGAA, `code` a sigla (ex.: FCTE).'

````

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