Tutorial de acesso à API via programação
Para se cadastrar na API, clique aqui. Acesse o GitHub do pacote R aqui.
Acesso via R
Antes de acessar diretamente a API do Atlas da Notícia utilizando R, considere que temos um pacote R específico para essa linguagem, que facilita bastante o acesso aos dados.
Caso queira utilizar a API sem o pacote, vamos utilizar os pacotes httr
, para fazer requisições ao servidor, e jsonlite
, para converter os dados de json para formato tabular.
Para gerar seu token, é necessário fazer uma requisição POST
. Para isso, utilize o código a seguir:
token = content(
POST(url = "https://api.atlas.jor.br/api/v1/auth/login",
body = list("email" = "email@email.com", "password" = "12345678"),
encode = "json", handle = NULL),
as = "text")
Depois dessa etapa, vamos salvar o retorno inteiro (token e metadata) como variável a partir do json retornado token = fromJSON(token)
, e então próprio token como variável tk <- token[[1]]
, a fim de autenticar nossa consulta à base de dados.
Com a autenticação feita, resta apenas realizar uma requisição GET
e transformá-la em uma tabela. Abaixo, um exemplo que retorna os veículos do Estado de Rondônia.
tabela <- fromJSON(content(GET(url = "https://api.atlas.jor.br/api/v1/data/analytic?estado=RO",
add_headers(Authorization = paste("Bearer", tk, sep = " "))),
as = "text"))
Veja o código completo abaixo, que pode ser acessando também neste link.