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-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.