Acesse os dados de forma fácil

O nosso portal de transparência possui uma API para facilitar o seu programa a consumir os nossos dados.

Acesso aos dados

Para acessar os dados basta acessar o endereço:

http://api.instituicao.gov.br/requisicao?tipo=<TIPO>&filtro=<FILTRO>.json

Como destacado no endereço de chamada acima podesse escolher o tipo de dado que se deseja acessar e aplicar um filtro a este dado. Tipos de dados válidos, e seus filtros, são:

  • Convenios: relaciona todos os convênios firmados pela instituição. TIPO: convenios, FILTRO:
    • ativos
    • encerrados
    • todos
  • Projetos: relaciona todos os projetos desenvolvidos pela instituição. TIPO: projetos, FILTRO:
    • ativos
    • encerrados
    • todos
  • Funcionarios: relaciona os funcionários da instituição. TIPO: funcionarios, FILTRO:
    • diretoria
    • gerencia
    • concursados
    • tercerizados
    • estagiarios

Exemplo

A chamada abaixo é um exemplo de chamada que retorna todos os convênios que estão ativos na instituição:

http://api.instituicao.gov.br/requisicao?tipo=convenios&filtro=ativos.json

Retorno obtido

A API do portal de transparência retorna seus dados no formato JSON, sendo que este arquivo pode ser lido facilmente e é facilmente interpretado por programas simples.

Um exemplo de retorno válido para a solicitação acima é:

{ "requisicao": { "data_hora": "27-03-2017-09-33", "dados_requisitados": "convenios", "filtro": "ativos", "registros": "3" }, "dados": [{ "nome": "convenio1", "id": "1", "descricao": "descricao do convenio 1", "situacao": "ativo" "duracao_meses": "6" "contrato": "arquivos.instituicao.gov.br/arquivos/convenio1.pdf"}, { "nome": "convenio4", "id": "4", "descricao": "descricao do convenio 4", "situacao": "ativo" "duracao_meses": "3" "contrato": "arquivos.instituicao.gov.br/arquivos/convenio4.pdf"}, { "nome": "convenio11", "id": "1", "descricao": "descricao do convenio 11", "situacao": "ativo" "duracao_meses": "12" "contrato": "arquivos.instituicao.gov.br/arquivos/convenio11.pdf"}] }