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: 5a971ac225d5082e69c0e247
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 |