Politique de compatibilité
L'API n'a pas de version d'URL. Au lieu de cela, nous suivons trois règles afin que les intégrations déjà en production ne cessent pas de fonctionner sans avertissement :
- Le nouveau comportement obtient une nouvelle URL. Lorsque le format des données change, l'ancien point de terminaison continue de répondre exactement comme avant et le changement se déroule dans l'autre sens.
- Des champs peuvent être ajoutés à tout moment. Traitez la réponse comme un objet ouvert : ignorez ce que vous ne savez pas plutôt que de le casser.
- Les points de terminaison abandonnés restent en ligne. Ils quittent la référence, mais continuent de répondre – la liste ci-dessous montre le remplacement de chacun.
Avez-vous des questions sur des changements ou avez-vous besoin d'une date limite pour migrer ? Écrivez à contaovosdengue@gmail.com.
Points de terminaison abandonnés
Ils continuent tous à travailler et renvoient exactement le même contenu qu'avant. Ils ne reçoivent tout simplement pas de nouveaux champs.
| Point de terminaison | Utiliser sur place | Raison |
|---|
/api/getmunicipalityblockspublic | /api/getmunicipalityblocksvisitpublic | Le nom disait des îlots, mais le retour se faisait toujours par des visites. |
/api/getmunicipalityedlvisitspublic | /api/getmunicipalityedlmaintenancepublic | Les EDL reçoivent un entretien, pas des visites ; les champs sont passés de edl_visit_* à edl_maintenance_*. |
Changer l'historique
2026-09-11
Datas e coordenadas impossíveis passam a ser recusadas
Changement de comportement
- Toda data de registro (instalação e coleta da leitura, visita, manutenção e instalação de EDL) precisa estar entre 01/01/1900 e hoje. Antes, a data de coleta só tinha o formato conferido, e um ano digitado com três dígitos, como
0202-08-14, era gravado. Carga retroativa de qualquer ano a partir de 1900 continua aceita. - Latitude ou longitude exatamente zero passam a ser recusadas em todos os endpoints: é posição que não foi registrada, não um lugar.
- A resposta é
400 com a frase dizendo qual campo e por quê, por exemplo "Data de coleta: 0202-08-14 é anterior a 01/01/1900 — confira o ano."
Quem já manda datas e coordenadas reais não precisa mudar nada. Um envio que antes era aceito com data impossível ou coordenada zerada passa a receber 400 em vez de 200.
2026-09-11
Edição de registros, chave no cabeçalho e correções
Nouvelles
- Novos
/api/posteditovitrap, /api/posteditcounting, /api/posteditblock, /api/posteditaction, /api/posteditedl, /api/posteditedlmaintenance e /api/posteditplace — editam registros existentes, com edição parcial, troca de código ou data e cópia opcional do endereço novo para as leituras antigas (atualizar_desde). - A chave pode ir no cabeçalho
Authorization: Bearer SUA_CHAVE, em todos os endpoints. O ?key= continua aceito. /api/postdeleteaction respondia erro 500 em toda chamada que achava o quarteirão; agora apaga a visita, inclusive as criadas pela própria API./api/postcounting: quando a coordenada da ovitrampa muda, os campos de endereço que não vieram no pedido passam a ser mantidos. Antes eram apagados.- Apagar uma leitura, visita ou manutenção pela API passou a recalcular a média do registro (ovos da ovitrampa, visitas do quarteirão, água da EDL).
Nenhuma integração existente precisa mudar. A única diferença visível para quem já integrou é a do /api/postcounting: um endereço que antes era apagado agora é mantido.
2026-08-01
Noms corrects pour les îlots et la maintenance EDL
NouvellesArrêt
- Nouveau
/api/getmunicipalityblocksvisitpublic — visites effectuées par îlots, avec un enregistrement par visite. Même contenu que l'ancien /api/getmunicipalityblockspublic, maintenant avec le bon nom. - Nouveau
/api/getmunicipalityblockspublic-2 — les îlots eux-mêmes, un enregistrement par îlot, avec polygone, propriétés totales par type et parts moyennes. - Nouveau
/api/getmunicipalityedlmaintenancepublic — Maintenance EDL, avec les champs renommés de edl_visit_* à edl_maintenance_*. - Discontinué
/api/getmunicipalityblockspublic e /api/getmunicipalityedlvisitspublic — sont toujours à l'antenne, avec les mêmes retours que toujours.
Aucune intégration existante ne doit être modifiée. La migration n'est recommandée que pour ceux qui souhaitent les noms de champs corrects ou les données des îlots séparées des visites.
2026-07-30
Ovitrap rural et correction de la semaine épidémiologique
Nouvelles
/api/postcounting a commencé à accepter ovitrap_type_id lors de l'installation d'un ovitrap : 1 pour urbain (standard, lorsque le champ n'est pas envoyé) et 2 pour rural. Toute autre valeur est renvoyée 400 "Tipo de ovitrampa inválido".- Validation de la semaine épidémiologique de
/api/postcounting e /api/postaction J'ai commencé à comparer l'année et la semaine ensemble. Auparavant, une date d'une année future comportant un faible nombre de semaines pouvait être acceptée à tort.
2026-07-28
Nouveaux points finaux publics pour les EDL, les ovitraps et les points stratégiques
Nouvelles
/api/getmunicipalityedlspublic — EDL enregistrées par commune./api/getmunicipalityovitrapspublic — ovitraps enregistrés, avec coordonnées et nombre moyen d'œufs./api/getmunicipalityplacespublic — points stratégiques, avec type, sous-type et zone.- Tout le monde accepte
country, state, municipality e page, comme les autres points de terminaison publics.
2026-04-23
Envoi de visites par îlots
Nouvelles
- Nouveau
/api/postaction — enregistre une visite avec les propriétés travaillées et les gisements trouvés par classe (a1, a2, b, c, d1, d2, e). - Envoi
block_group_id au lieu de block_id, l'îlot est automatiquement créé au sein de la commune clé. - Réponses spécifiques :
403 lorsque l'îlot provient d'une autre commune et 409 lorsqu'il y a déjà une visite pour cet îlot, cette année et cette semaine.
2026-03-27
La clé est maintenant lue à partir de l'URL
Changement de comportement
Sur tous les points de terminaison privés, le key a commencé à être lu exclusivement à partir de la chaîne de requête (?key=SUA_CHAVE), y compris en POST. Les intégrations qui ont uniquement envoyé la clé dans le corps du formulaire commencent à recevoir 404 "Wrong key" — déplacez simplement la clé vers l'URL, en conservant les autres champs dans le corps.
2026-02-24
Suppression des visites et des îlots
Nouvelles
/api/postdeleteaction — supprime la visite d'un îlot, identifié par block_group_id e date./api/postdeleteblock — retirez l'îlot.
2026-02-04
Filtrer par période dans les décomptes privés
Nouvelles
/api/lastcounting a commencé à accepter date_start e date_end, vous permettant de réduire le nombre par plage de dates au lieu de faire défiler chaque page.
2025-10-19
Synchronisation incrémentielle sur les décomptes publics
Nouvelles
/api/lastcountingpublic a commencé à accepter id (uniquement les occurrences de cet identifiant), date (date d'inclusion) e date_collect (data de coleta). Ces filtres vous permettent de conserver une base en miroir sans dégrader l’intégralité de votre historique.
2025-03-18
Filtrer par période dans les décomptes publics
Nouvelles
/api/lastcountingpublic a commencé à accepter date_start e date_end.
2025-03-06
Retrait des ovitraps
Nouvelles
/api/postdeleteovitrap — supprime un ovitrap du ovitrap_group_id, dans la commune de Chave.