Esta página é voltada para Desenvolvedores, Geeks, Nerds, e pessoas que sabem programar computadores e desejam utilizar nossos dados para o desenvolvimento de sistemas baseados neles.
Sobre a API
Os dados do INEP não são publicados segundo os conceitos internacionais de dados abertos, sendo disponibilizados em páginas HTML sob diversas formas, desde grandes arquivos compactados contendo os dados, até "sistemas" feitos no excel. Isto leva a muitos problemas e dificuldades na utilização desses dados pela população, inclusive no desenvolvimento de aplicações como este projeto.
Com o objetivo de melhorar a disponibilização desses dados, de forma a incentivar o uso dos mesmos para geração de novas iniciativas por terceiros, criamos esta API (Application Programming Interface) para republicação dos dados. Ela ainda está na primeira versão, mas já completa. Objetivamos sempre atualiza-la e melhora-la.
A API contém principalmente os dados das escolas e das estatísticas. O acesso é via chamadas HTTP (REST) e o retorno é sempre no formato JSON. Abaixo seguem os detalhes da API.
| Entrada | Descrição |
|---|---|
| /api/cidades/{estado} | Método auxiliar que retorna o código e o nome de todas as cidades do referido estado. Necessário para poder realizar buscas pelo código da cidade |
| /api/escola/{id} | Detalha os dados da escola |
| /api/escolas | Busca simples por escolas |
| /api/escolas/buscaavancada | Busca avançada por escolas |
| /api/estatisticas | Retorna as estatísticas das escolas |
| /api/estatisticas/{indice}/{codescola} | Retorna as estatísticas de um índice específico para todos os estados, regiões e do país, com destaque para a cidade/estado/região da escola |