Dados abertos e Web service

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.

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, ou seja, que possibilite seu uso irrestrito e automatizado através da Web. Além disso, é imprescindível que seja utilizado um formato amplamente conhecido. Os formatos CSV, ODS, RDF, XML e JSON são os formatos mais comuns para dados abertos.

Consulte a Cartilha Técnica para Publicação de Dados Abertos no Portal Brasileiro de Dados Abertos

Também é possível consultar os dados abertos dos processos judiciais do TRE-PB das seguintes formas:

Por meio Painel de Estatísticas do DataJud

Na página do Painel de Estatísticas do DataJud, na aba de downloads, há API para consulta ao número único dos processos e livre download.

Por meio da API Pública do DATAJUD.

Para isso utilize os dados abaixo:

Endpoint do TRE-PB: https://api-publica.datajud.cnj.jus.br/api_publica_tre-pb/_search
API Key atual do DATAJUD:
- Authorization: APIKey cDZHYzlZa0JadVREZDJCendQbXY6SkJlTzNjLV9TRENyQk1RdnFKZGRQdw==

Exemplo de processo para consulta: 06000010420256150043

Exemplo de consulta via API utilizando Phyton

import requests
import json

url = "https://api-publica.datajud.cnj.jus.br/api_publica_tre-pb/_search"

payload = json.dumps({
"query": {
"match": {
"numeroProcesso": "06000010420256150043"
}
}
})

#Substituir <API Key> pela Chave Pública
headers = {
'Authorization': 'APIKey cDZHYzlZa0JadVREZDJCendQbXY6SkJlTzNjLV9TRENyQk1RdnFKZGRQdw==',
'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

➕Visite também a página Estatísticas para obter outros dados e informações da atuação do TRE-PB.

Mais exemplos de disponibilização de dados abertos no site do TRE-PB:

Estatísticas do eleitorado na Paraíba

Estruturas remuneratórias - Cargos efetivos

Estrutura remuneratória - Cargos em comissão e funções de confiança

Web service

A Lei de Acesso à Informação, LAI, preconiza que os órgãos e entidades públicas devem possibilitar o acesso automatizado a seus dados por sistemas externos em formatos abertos, estruturados e legíveis por máquina. Os dados são abertos quando permitem a sua utilização, cruzamento e compartilhamento por qualquer pessoa.

Um Web service é um conjunto de métodos acedidos e invocados por outros programas utilizando tecnologias Web, ou seja, é utilizado para transferir dados através de protocolos de comunicação para diferentes plataformas, independentemente das linguagens de programação utilizadas nessas plataformas.

Neste contexto, os Web Service e/ou Api’s permitem que novas aplicações possam interagir com as já existentes, o que viabiliza a compatibilidade entre plataformas diferentes.

Resultados via API do sistema Histórico de Eleições

O TRE-PB apresenta um conjunto de web services para prover informações referentes aos resultados de eleições realizadas a partir de 1945.

API do Sistema de Histórico de Eleições

Como consultar um serviço (Passo a Passo)

Escolha o Endpoint: Clique sobre o nome do serviço que deseja consultar para expandir os detalhes.
Entenda os Parâmetros: Veja a seção "Parameters". Ali a API informa o que você precisa enviar (como um título de eleitor ou zona eleitoral).
Botão "Try it out": Clique neste botão (canto superior direito da seção expandida) para habilitar a edição dos campos.
Preencha os dados: Digite as informações solicitadas nos campos de texto.
Executar: Clique no botão azul "Execute".

Interpretando a Resposta (Responses)

Após clicar em "Execute", a ferramenta mostrará:

Curl: O comando de linha de código que você usaria para fazer essa chamada de um sistema externo.
Request URL: O endereço real que foi consultado.
Server Response:
- Code 200: Sucesso. O dado solicitado aparecerá logo abaixo no formato JSON.
- Code 400 ou 404: Erro de digitação ou dado não encontrado.
- Code 401 ou 403: Problema de permissão (necessita de chave de acesso)