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.

Acesso via Python

Sérgio Spagnuolo (Coordenador de dados) é responsável pela área de dados e tecnologia do Atlas da Notícia. Também é diretor do veículo independente de tecnologia Núcleo Jornalismo, e fundador da agência de dados Volt Data Lab.