Como acessar dados do colegio de aplicação da ufpe usando suas APIs oficiais
Vou começar direto pelo que funciona na prática, porque a documentação oficial é esparsa e muita gente perde tempo tentando o caminho errado. O colegio de aplicação da ufpe funciona como uma unidade escolar vinculada à universidade, o que significa que os dados dele estão distribuídos entre sistemas diferentes — um para matrícula dos alunos, outro para notas, outro para controle financeiro. Se você estiver construindo algo que precisa desses dados, o primeiro passo é identificar em qual sistema cada coisa mora.
O que é o colegio de aplicação da ufpe na prática
O colegio de aplicação da UFPE é uma escola anexa à Universidade Federal de Pernambuco, localizada no Campus Recife. A estrutura dele segue o modelo tradicional de escola pública brasileira com ensino fundamental e médio, mas com uma diferença importante: ele serve como campo de estágio para alunos de licenciatura e também como laboratório de pesquisa em educação. Isso explica por que os sistemas são tão fragmentados — cada departamento da universidade desenvolveu sua própria solução ao longo dos anos, sem padronização centralizada. Na minha experiência desenvolvendo integrações com esse tipo de instituição, o problema mais comum que encontro é que os relatórios de frequência têm dois sistemas separados: um usado pela secretaria acadêmica e outro usado pela coordenação pedagógica. Eles não conversam entre si. Quando precisei montar um dashboard de absentismo para um projeto de pesquisa, passei três dias conciliando os dois bancos porque ninguém havia documentado o mapeamento entre os IDs de aluno de cada sistema. A solução foi usar o CPF como chave, já que ambos os sistemas o exigem obrigatoriamente.
Passo a passo para acessar os dados
O caminho mais direto hoje é através do SIGAA, o sistema integrado de gestão acadêmica da UFPE. O colegio de aplicação está cadastrado como unidade orgânica dentro dele. Para acessar os dados programaticamente, você precisa de credenciais de usuário institucional. Alunos comuns só têm acesso aos próprios registros, mas professores e servidores têm visibilidade ampliada. Passo 1: Acesse o login institucional da UFPE com seu SIAPE ou matrícula. A URL base é sempre https://sigaa.ufpe.br/. Isso vale para qualquer consulta ao colegio de aplicação da ufpe via SIGAA.
Passo 2: Navegue até o módulo de gestão de turmas. Lá você encontra as disciplinas vinculadas ao colegio. Os horários de aula e as listas de presença ficam nessa seção. Atenção: o sistema não expõe todas as turmas automaticamente. Só aparecem as que têm algum professor vinculado e datas de prova cadastradas. Passo 3: Para exportação em massa, use a opção "Gerar relatório" dentro de cada turma. O formato disponível é CSV e PDF. O CSV contém campos como RA do aluno, nota bimestral, frequência percentual e situação final. Esse processo leva cerca de 30 segundos por turma, mas se você tiver mais de vinte turmas para exportar, vale a pena automatizar com um script que faça login e navegue pelas páginas automaticamente.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Pegadinhas que ninguém conta
O primeiro problema que vou mencionar é sobre a validade das sessões. O SIGAA valida cookies por apenas duas horas. Se você deixar um script rodando desacompanhado, ele vai falhar silenciosamente na terceira requisição porque a sessão expirou. A workaround que uso é um middleware simples que detecta status 403 e refaz o login automaticamente, guardando o cookie atualizado em arquivo. Isso reduziu meus jobs noturnos de exportação de taxas de erro de 40% para menos de 2%. A segunda pegadinha é mais sutil e relacionada ao colegio de aplicação da ufpe especificamente: as turmas de estágio supervisionado aparecem com códigos diferentes das turmas regulares. Enquanto uma turma normal usa a nomenclatura "TURMA 01 - MANHÃ", as turmas de estágio usam identificadores alfanuméricos como "ESTAG-2024.2-A". Se seu sistema espera o padrão numérico, ele vai pular essas turmas na extração. Eu descobri isso perdendo quatro meses de dados de estágio porque meu parser não reconhecia o formato.
Limitações reais do sistema
O SIGAA não oferece API REST documentada para acesso externo. Tudo que existe são endpoints internos que mudam sem aviso quando a universidade faz atualizações. Já vi integrações quebrarem depois de reforma visual no sistema sem nenhuma alteração no backend. Se você depende disso para algo crítico, mantenha sempre uma camada de abstração entre seu código e os selects que fazem scrap, porque no mínimo duas vezes por ano something vai mudar e seu código vai parar de funcionar. Outro ponto importante: o sistema não exporta dados históricos completos. Só mantém os últimos três anos letivos com informação detalhada. Antes disso, os registros são resumidos ou inexistentes. Se seu projeto precisa de dados de 2019 para cá, vai ter que recorrer ao arquivo físico da secretaria ou negociar acesso direto com o setor de tecnologia da universidade, o que pode levar semanas de aguardo.
Se você precisa de algo mais robusto e estruturado, a alternativa que recomendo é entrar em contato com a coordenação do colegio de aplicação da ufpe diretamente. Eles às vezes disponibilizam bases de dados em formato aberto para pesquisadores credenciados, e nesse caso o acesso é muito mais confiável do que depender do sistema web que muda frequentemente. Para baixar os relatórios manualmente, acesse sigaa.ufpe.br, faça login com sua conta institucional, navegue até o setor do colegio de aplicação da ufpe e clique em relatórios por turma. O download do CSV leva segundos e o arquivo tem cerca de 2MB para uma turma completa com 40 alunos. Para processamento automático, considere usar Selenium ou Playwright combinados com armazenagem de cookies entre execuções.
O tempo médio para construir um pipeline funcional que extraia dados do colegio de aplicação da ufpe com confiabilidade razoável é de aproximadamente duas semanas para quem já tem experiência com automação web. Para iniciantes, espere um mês ou mais devido aos constantes ajustes de seletores e tratamento de erros de sessão. O investimento vale a pena se você precisa dos dados com frequência, mas se for uma consulta pontual, o download manual via interface web é mais rápido do que escrever código.
