Sobre a API

Esta API possui endpoints privados e públicos. Para utilizar a API privada, você precisará de uma chave. Para adquirir sua chave envie um email para contaovosdengue@gmail.com com os seguintes pontos:

  • Explicando por que necessita de acesso a API
  • Qual o nível de acesso (municipal, regional, estadual, país)
  • De qual região geográfica pertence

A chave será composta por 45 letras de forma aleatória.

Endpoints Privados

Últimas contagens lançadas

Endpoint para verificar as últimas contagens lançadas, com número de ovos e dados da ovitrampa. Precisa dos seguintes parâmetros:

  • key: a sua chave da API, com ela será definido o escopo das últimas contagens (municipal, regional, estadual, país).
  • page: a paginação que está situado. Caso não indique, será considerada a página 1. Precisa ser um número.

curl -X GET -d "key=KEY&page=1" https://contaovos.com/en-us/api/lastcounting

Endpoints Públicos

Últimas contagens lançadas

Endpoint para verificar as últimas contagens lançadas por localização (Municipal, Estatual e País) com o número de ovos e dados da ovitrampa. Pode receber os seguintes parâmetros:

  • state: pode ser informado o código do estado. Exemplo: state=RJ.
  • municipality: pode ser informado o nome do município. Exemplo: municipality=Ponta Pora
  • country: pode ser informado o nome do município. Exemplo: country=Brasil. Caso não indique será considerado "Brasil".
  • page: a paginação que está situado. Caso não indique, será considerada a página 1. Precisa ser um número.

curl -X GET -d "municipality=Ponta%20Pora" https://contaovos.com/en-us/api/lastcountingpublic

curl -X GET -d "state=MG" https://contaovos.com/en-us/api/lastcountingpublic

OBS: Caso não seja passado nenhum parâmetro, o endpoint devolverá as últimas contagens do Brasil.

Últimas ações em quarteirões

Endpoint que traz dados das ações nos quarteirões. Pode receber os seguintes parâmetros:

  • state: pode ser informado o código do estado. Exemplo: state=RJ.
  • municipality: pode ser informado o nome do município. Exemplo: municipality=Ponta Pora
  • country: pode ser informado o nome do município. Exemplo: country=Brasil. Caso não indique será considerado "Brasil".
  • page: a paginação que está situado. Caso não indique, será considerada a página 1. Precisa ser um número.

curl -X GET -d "municipality=Vista%20Alegre" https://contaovos.com/en-us/api/getmunicipalityblockspublic

curl -X GET -d "state=MS" https://contaovos.com/en-us/api/getmunicipalityblockspublic