CLIQUE AQUI PARA BAIXAR AS INSTRUÇÕES
INSTRUÇÕES OPEN T.I. API (REST API / JSON)
A Lei Federal nº 12.527/11 (Lei de Acesso à Informação) no Art. 8º, §3º, inciso III, exige o acesso automatizado por sistemas externos em formatos abertos, estruturados e legíveis por máquina. Para cumprir esta exigência legal, através da ferramenta OPEN T.I. API (rest api), desenvolvida pela Open Tecnologia, é possível exportar todas as informações contidas neste portal, desta entidade, utilizando o formato JSON.
JSON (JavaScript Object Notation – Notação de Objetos JavaScript) é uma formatação leve de troca de dados. Para seres humanos, é fácil de ler e escrever. Para máquinas, é fácil de interpretar e gerar. Está baseado em um subconjunto da linguagem de programação JavaScript, Standard ECMA-262 3a Edição -Dezembro – 1999. JSON é em formato texto e completamente independente de linguagem, pois usa convenções que são familiares às linguagens C e familiares, incluindo C++, C#, Java, JavaScript, Perl, Python e muitas outras. Estas propriedades fazem com que JSON seja um formato ideal de troca de dados.
Para utilizar o serviço, basta acessar a url base, incluindo ao final dela a categoria de dados mais os argumentos obrigatórios, conforme exemplificados e descritos em detalhes nas tabelas abaixo.
URL BASE: http://www.imprensaoficial.org/openti_api/
CÓDIGO DESTA ENTIDADE: 5784118fb5d4082f3dd8ed58
Exemplo 1:
http://www.imprensaoficial.org/openti_api/entidade/?cod_ent=CÓDIGO_DA_ENTIDADE
O exemplo 1 requisita os dados da ENTIDADE.
Exemplo 2:
http://www.imprensaoficial.org/openti_api/materias/?cod_ent=CÓDIGO_DA_ENTIDADE&ano=2017&filtro=licitacoes
O exemplo 2 requisita as licitações da ENTIDADE, no ano de 2017.
TIPOS DE DADO
TIPO | DESCRIÇÃO |
TEXTO CURTO | Até 254 caracteres |
TEXTO LONGO | Textos longos |
LINK | Atalho para documento/imagem |
MONETÁRIO | Valor monetário (formato: R$ 8,88) |
DATA | Data (formato: DD/MM/AAAA) |
LÓGICO | Lógico (formato: SIM/NÃO) |
TABELA ENTIDADE
CATEGORIA: entidade
ARGUMENTO OBRIGATÓRIO:
- “cod_ent” – Código de identificação da entidade. Exemplo: “cod_ent=d4e8f4D8G4G5a4gf8879”.
NOME DO CAMPO | TIPO DE DADO |
CATEGORIA_DADOS | TEXTO CURTO |
IDENTIFICACAO | TEXTO CURTO |
PODER | TEXTO CURTO |
CNPJ | TEXTO CURTO |
GESTOR | TEXTO CURTO |
ESTADO | TEXTO CURTO |
MUNICIPIO | TEXTO CURTO |
ENDERECO | TEXTO CURTO |
TELEFONE | TEXTO CURTO |
TEXTO CURTO | |
BRASAO | LINK |
SITE | LINK |
TABELA SIC – SERVIÇO PRESENCIAL DE INFORMAÇÃO AO CIDADÃO
CATEGORIA: sic
ARGUMENTO OBRIGATÓRIO:
- “cod_ent” – Código de identificação da entidade. Exemplo: ”cod_ent=d4e8f4D8G4G5a4gf8879”.
NOME DO CAMPO | TIPO DE DADO |
CATEGORIA_DADOS | TEXTO CURTO |
ENTIDADE | TEXTO CURTO |
IDENTIFICACAO | TEXTO CURTO |
ENDERECO | TEXTO CURTO |
TELEFONE | TEXTO CURTO |
HORARIO_ATENDIMENTO | TEXTO CURTO |
TABELA ESTRUTURA ADMINISTRATIVA/ORGANIZACIONAL
CATEGORIA: estrutura
ARGUMENTO OBRIGATÓRIO:
- “cod_ent” – Código de identificação da entidade. Exemplo: “cod_ent=d4e8f4D8G4G5a4gf8879”.
NOME DO CAMPO | TIPO DE DADO |
CATEGORIA_DADOS | TEXTO CURTO |
ENTIDADE | TEXTO CURTO |
IDENTIFICACAO | TEXTO CURTO |
GESTOR | TEXTO CURTO |
ENDERECO | TEXTO CURTO |
TELEFONE | TEXTO CURTO |
TEXTO CURTO | |
HORARIO_ATENDIMENTO | TEXTO CURTO |
COMPETENCIAS | TEXTO LONGO |
TABELA UNIDADES ORÇAMENTÁRIAS
CATEGORIA: unidade_orcamentaria
ARGUMENTO OBRIGATÓRIO:
- “cod_ent” – Código de identificação da entidade. Exemplo: “cod_ent=d4e8f4D8G4G5a4gf8879”.
NOME DO CAMPO | TIPO DE DADO |
CATEGORIA_DADOS | TEXTO CURTO |
ENTIDADE | TEXTO CURTO |
CODIGO | TEXTO CURTO |
IDENTIFICACAO | TEXTO CURTO |
TABELA UNIDADES GESTORAS
CATEGORIA: unidade_gestora
ARGUMENTO OBRIGATÓRIO:
- “cod_ent” – Código de identificação da entidade. Exemplo: “cod_ent=d4e8f4D8G4G5a4gf8879”.
NOME DO CAMPO | TIPO DE DADO |
CATEGORIA_DADOS | TEXTO CURTO |
ENTIDADE | TEXTO CURTO |
CODIGO | TEXTO CURTO |
IDENTIFICACAO | TEXTO CURTO |
TABELA RECEITAS 131
CATEGORIA: receitas
ARGUMENTOS OBRIGATÓRIOS:
- “cod_ent” – Código de identificação da entidade. Exemplo: “cod_ent=d4e8f4D8G4G5a4gf8879”;
- “ano” – Ano de referência da consulta. Exemplo/formato: “ano=2015”.
NOME DO CAMPO | TIPO DE DADO |
CATEGORIA_DADOS | TEXTO CURTO |
ENTIDADE | TEXTO CURTO |
UNIDADE_GESTORA | TEXTO CURTO |
DATA_PUBLICACAO | DATA |
DATA_EVENTO | DATA |
TIPO | TEXTO CURTO |
MODALIDADE | TEXTO CURTO |
DESCRICAO | TEXTO LONGO |
VALOR | MONETÁRIO |
FONTE | TEXTO CURTO |
NATUREZA | TEXTO CURTO |
DESTINACAO | TEXTO CURTO |
TABELA DESPESAS 131
CATEGORIA: despesas
ARGUMENTOS OBRIGATÓRIOS:
- “cod_ent” – Código de identificação da entidade. Exemplo: “cod_ent=d4e8f4D8G4G5a4gf8879”;
- “ano” – Ano de referência da consulta. Exemplo/formato: “ano=2015”.
NOME DO CAMPO | TIPO DE DADO |
CATEGORIA_DADOS | TEXTO CURTO |
ENTIDADE | TEXTO CURTO |
UNIDADE_ORCAMENTARIA | TEXTO CURTO |
DATA_PUBLICACAO | DATA |
DATA_EVENTO | DATA |
ETAPA | TEXTO CURTO |
NUMERO_ADMINISTRATIVO | TEXTO CURTO |
NUMERO_LICITACAO | TEXTO CURTO |
BEM_SERVICO | TEXTO LONGO |
CREDOR | TEXTO CURTO |
CPF_CNPJ | TEXTO CURTO |
VALOR | MONETÁRIO |
FUNCAO | TEXTO CURTO |
SUBFUNCAO | TEXTO CURTO |
NATUREZA | TEXTO CURTO |
FONTE | TEXTO CURTO |
NUMERO_ETAPA | TEXTO CURTO |
PROCESSO_LICITATORIO | TEXTO CURTO |
TABELA MATÉRIAS PUBLICADAS
CATEGORIA: materias
ARGUMENTOS OBRIGATÓRIOS:
- “cod_ent” – Código de identificação da entidade. Exemplo: “cod_ent=d4e8f4D8G4G5a4gf8879”;
- “ano” – Ano de referência da consulta. Exemplo/formato: “ano=2015”;
- “filtro” – Filtra pela natureza da matéria. Exemplo/formato: “filtro=todas”.
- “filtro=todas” – Lista todas as matérias do ano escolhido;
- “filtro=dispensa” – Lista todas as DISPENSAS E INEXIGIBILIDADES do ano escolhido;
- “filtro=licitacoes” – Lista todas as LICITAÇÕES do ano escolhido;
- “filtro=contratos” – Lista todos os CONTRATOS E ADITIVOS do ano escolhido;
- “filtro=decretos” – Lista todos os DECRETOS E PORTARIAS do ano escolhido.
NOME DO CAMPO | TIPO DE DADO |
CATEGORIA_DADOS | TEXTO CURTO |
ENTIDADE | TEXTO CURTO |
ORGAO_SETOR | TEXTO CURTO |
DATA_PUBLICACAO | DATA |
VEICULOS | TEXTO CURTO |
CATEGORIA | TEXTO CURTO |
REPUBLICACAO | LÓGICO |
ACAO_CORRETIVA | TEXTO CURTO |
TITULO | TEXTO CURTO |
TIPO_MIDIA | TEXTO CURTO |
TEXTO_CURTO | TEXTO LONGO |
LINK | |
PUBLICACAO_JORNAL | LINK |
PUBLICACAO_DOE | LINK |
PUBLICACAO_DOU | LINK |