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