Dados Abertos

Dados Abertos constituem a publicação e disseminação de dados e informações públicas na Web, seguindo alguns critérios que possibilitam sua reutilização e o desenvolvimento de aplicativos por toda a sociedade. O paradigma de dados abertos está fundamentado na constatação de que o dado, quando compartilhado abertamente, tem seu valor e seu uso potencializados.

A filosofia de dados abertos não define exaustivamente uma lista de formatos permitidos. Para ser considerado um dado aberto, o conjunto de dados deve estar disponível em um formato de especificação aberta, não proprietário, e estruturado. Além disso, é imprescindível que seja utilizado um formato amplamente conhecido.

Acesse os dados abertos pelo TRE-RN a partir do Portal de Dados Abertos, disponível na Internet.

Formatos abertos disponíveis para download

Os dados disponibilizados no Portal de Dados Abertos do TRE-RN podem ser baixados pelos usuários em quaisquer dos seguintes formatos abertos de arquivo:

JSON (JavaScript Object Notation)
É um padrão aberto de estruturação de dados baseado em texto e legível por humano. A especificação é a RFC 4627. JSON ganhou maior utilização com o advento do Ajax. A serialização em JSON é muito simples e resulta em uma estrutura pouco verbosa o que se mostra uma ótima alternativa para o XML. JSON possibilita serialização de estrutura de objetos complexos, como listas e subpropriedades. JSON está se tornando o padrão mais utilizado para integração de dados entre repositórios e frameworks, também está se tornando o padrão nativo de armazenamento em alguns bancos de dados modernos.

XML (Extensible Markup Language)
É um conjunto de regras para codificar documentos com estrutura hierárquica e em um formato legível por máquina. É baseado em texto e tem como principais objetivos simplicidade, extensibilidade e usabilidade. XML é largamente utilizado como formato de troca de dados nos clássicos Web Services SOAP. Possui uma ampla gama de ferramentas associadas, tais como o padrão XSLT que permite transformar para outra estrutura XML ou outro formato. Apesar de sua ampla utilização, tem sido menos encorajada a utilização desse formato para integração de aplicações na Web, por utilizar mais recursos para transmissão e para o processamento do dados. Em substituição, recomenda-se utilizar JSON.

CSV (Comma-Separated Values, ou valores separados por vírgula)
É um formato para armazenamento de dados tabulares em texto. A codificação é muito simples: cada linha do arquivo representa uma linha na tabela, e as colunas são separadas por vírgula. Campos que podem conter vírgula devem ser delimitados por aspas. CSV é recomendado para representação de estrutura de dados mais simples, de natureza tabular, onde não existem subpropriedades ou listas, gerando um arquivo menor e mais leve para processamento. Arquivos CSV são processáveis diretamente por editores de planilhas, como o OpenOffice e o MS Excel.

TSV (Tab Separated Values)
É um tipo de arquivo de texto que usa tabulações como delimitadores entre células em uma tabela. Os arquivos TSV são semelhantes aos arquivos CSV (valores separados por vírgula), mas a diferença é que um arquivo TSV usa tabulações em vez de vírgulas. Os arquivos TSV são comumente usados para intercâmbio de dados entre bancos de dados e outros aplicativos.

O TRE-RN disponibiliza para o público em geral, dados estruturados e legíveis por máquina que podem ser acessados por sistemas externos em formatos abertos. 

O acesso e estes dados é realizado por meio de uma Interface de Programação de Aplicativos (do inglês, “Application Programming Interface”, ou simplesmente API) web com suporte de consulta avançado. Esta API opera no estilo RPC, expondo todos os recursos do framework CKAN, utilizado para implementação do Portal de Dados Abertos do TRE-RN. Os dados retornados seguem o formato JSON e a documentação completa da API também é disponibilizada.

O fornecimento destas informações em formatos abertos tem por objetivo possibilitar ao cidadão, realizar cruzamentos e compartilhamentos dos dados, promovendo a prática de transparência no setor público.

É importante destacar que os dados referentes às eleições estão disponíveis através do Portal de Dados Abertos do TSE: https://dadosabertos.tse.jus.br/.

Exemplos de uso

a) Consultar os "n" primeiros registros do conjunto de dados específico:

FORMATO:

https://dados.tre-rn.jus.br/api/3/action/datastore_search?resource_id={CÓDIGO DO RECURSO}&limit={QTDE DE REGISTROS}

Exemplo de chamada: consultar os 5 primeiros registros do conjunto de dados "Endereços e Telefones"

https://dados.tre-rn.jus.br/api/3/action/datastore_search?resource_id=31d27afb-f3a1-4d92-b4b9-c62dbd283808&limit=5

Exemplo de retorno:

{
"_id":1,
"numero zona":18,
"chefe":"SOLANGE MADEIRO DA COSTA",
"endereço":"RUA PEDRO MATOS, 81",
"cep":59515000,
"município":"ANGICOS",
"telefone":"8499999999"
}

b) Consultar dados dos servidores ativos do Tribunal pelo nome:

FORMATO:

https://dados.tre-rn.jus.br/api/3/action/datastore_search?resource_id={CÓDIGO DO RECURSO}&q={NOME DO SERVIDOR}

Exemplo de chamada: consultar os dados do servidor "Osmar Fernandes"

https://dados.tre-rn.jus.br/api/3/action/datastore_search?resource_id=cf6aa7b7-e3fe-441b-bcab-faa9288cf5f8&q="Osmar Fernandes"

Exemplo de retorno:

{

"_id":418,
"nome":"OSMAR FERNANDES DE OLIVEIRA JÚNIOR",
"matricula":92440637,
"lotacao":"COSIS",
"nivel":"SUPERIOR",
"cargo":"ANALISTA JUDICIARIO",
"area":"APOIO ESPECIALIZADO",
"especialidade":"ANÁLISE DE SISTEMAS",
"situacao":"EFETIVO",
"comissao":"COORDENADOR",
"ingresso":"2006-02-16T00:00:00",
"rank":0.09016734

}

c) Consultar dados do(a) Juiz(a) Eleitoral pela zona:

FORMATO:

https://dados.tre-rn.jus.br/api/3/action/datastore_search?resource_id={CÓDIGO DO RECURSO}&q={ZONA ELEITORAL}

Exemplo de chamada: consultar dados do(a) Juiz(a) da 22ª zona eleitoral 

https://dados.tre-rn.jus.br/api/3/action/datastore_search?resource_id=37a91afb-601e-4bad-bf28-5935a92846eb&q="22ª ZE"

Exemplo de retorno:

{
"_id":1,
"nome":"ANA MARIA MARINHO DE BRITO",
"cargo":"JUIZ_ELEITORAL",
"sexo":"FEMININO",
"exercicio":"TITULARIZACAO",
"grau":"PRIMEIRO",
"datainicio":"2023-08-21T00:00:00",
"datafim":null,
"unidade":"22ª ZE",
"municipio":"ACARI",
"ativo":1,
"rank":0.09016734
}