Melhorar documentação da API e acesso aos dados

[endersonmaia]

Para facilitar o uso dos dados que estão sendo gerados, precisamos melhora a documentação de como fazer uso destes dados, seja via API ou seja buscando os arquivos.

[turicas]

Fiz um texto/resumo aqui: endoedgar/covid19-monitorbr#1

[endersonmaia]

acho que poderíamos adicionar uns exemplos com curl

• adicionar exemplos com curl

[turicas]

Não comentei aqui, mas subi o arquivo api.md que estou enviando para todo mundo que me manda dúvidas sobre a utilização da API.

[saramortara]

olá pessoal. primeiro, parabéns pela iniciativa, precisamos de dados realmente abertos. Escrevo aqui pois estou com uma dúvida em relação a API. A gente fez um pacote de R (coronabr) para baixar os dados diretamente da API. No início apenas o endereço https://brasil.io/api/dataset/covid19/caso/data retornava os dados completos, mas agora precisamos também de https://brasil.io/api/dataset/covid19/caso/data?page=2. É isso mesmo?

[turicas]

@saramortara sim, a API retorna 10k registros por página e você precisa paginar. Para facilitar você pode baixar o CSV compactado.

[dhonysilva]

Só uma dúvida básica (e talvez isso ajude na documentação). Os dados na API são acumulados ou absolutos de cada dia?

[turicas]

@dhonysilva acumulados.

[dhonysilva]

Estamos falando em 10.000 registros por página mas na verdade são 1000.

[dhonysilva]

Não sei se esse é o tópico correto.

O campo confirmed é do tipo int64 e o deaths float64. Não sei se realmente deve ser assim mas isso causa alguns problemas em ferramentas de análises.

[turicas]

Não sei se esse é o tópico correto.

O campo confirmed é do tipo int64 e o deaths float64. Não sei realmente deve ser assim mas isso causa alguns problemas em ferramentas de análises.

Você está enganado. Veja fieldsem: https://brasil.io/api/dataset/covid19

[endersonmaia]

Não sei se esse é o tópico correto.

O campo confirmed é do tipo int64 e o deaths float64. Não sei realmente deve ser assim mas isso causa alguns problemas em ferramentas de análises.

no JSON é só number, quem define o tipo estrito é a linguagem que faz o parsing e processa os dados