Tutorial de acesso à API via programação

Acesse a API utilizando linguagens de programação R e Python

Para se cadastrar na API, clique aqui. Acesse o GitHub do pacote R aqui.
Regras de uso da API do Atlas da Notícia
Entenda como utilizar nossos dados

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

Sobre quem escreveu
Sérgio Spagnuolo

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.

Great! You’ve successfully signed up.

Welcome back! You've successfully signed in.

You've successfully subscribed to Atlas da Notícia.

Success! Check your email for magic link to sign-in.

Success! Your billing info has been updated.

Your billing was not updated.