Kompatibilitätsrichtlinie
Die API verfügt über keine URL-Versionierung. Stattdessen befolgen wir drei Regeln, damit bereits in der Produktion befindliche Integrationen nicht ohne Vorwarnung nicht mehr funktionieren:
- Neues Verhalten erhält neue URL. Wenn sich das Datenformat ändert, reagiert der alte Endpunkt weiterhin genau wie zuvor und die Änderung erfolgt in die andere Richtung.
- Felder können jederzeit hinzugefügt werden. Behandeln Sie die Antwort als offenes Objekt: Ignorieren Sie, was Sie nicht wissen, anstatt es kaputt zu machen.
- Abgekündigte Endpunkte bleiben online. Sie verlassen die Referenz, antworten aber weiterhin – die Liste unten zeigt den Ersatz für jede einzelne.
Sie haben Fragen zu Änderungen oder benötigen eine Frist für die Migration? Schreiben Sie an contaovosdengue@gmail.com.
Abgekündigte Endpunkte
Sie alle funktionieren weiterhin und geben genau die gleichen Inhalte zurück wie zuvor. Sie erhalten einfach keine neuen Felder.
| Endpunkt | An Ort und Stelle verwenden | Grund |
|---|
/api/getmunicipalityblockspublic | /api/getmunicipalityblocksvisitpublic | Der Name sagte Blöcke, aber die Rückkehr erfolgte immer durch Besuche bei ihnen. |
/api/getmunicipalityedlvisitspublic | /api/getmunicipalityedlmaintenancepublic | EDLs erhalten Wartung, keine Besuche; Die Felder gingen aus edl_visit_* Zu edl_maintenance_*. |
Geschichte ändern
2026-08-01
Korrekte Namen für Blöcke und EDL-Wartung
NachrichtEinstellung
- Neu
/api/getmunicipalityblocksvisitpublic — Besuche werden in Blöcken durchgeführt, mit einem Datensatz pro Besuch. Gleicher Inhalt wie das alte /api/getmunicipalityblockspublic, jetzt mit dem richtigen Namen. - Neu
/api/getmunicipalityblockspublic-2 — die Blöcke selbst, ein Datensatz pro Block, mit Polygon, Gesamteigenschaften nach Typ und durchschnittlichen Anteilen. - Neu
/api/getmunicipalityedlmaintenancepublic — EDL-Wartung, wobei die Felder umbenannt wurden in edl_visit_* Zu edl_maintenance_*. - Auslaufmodell
/api/getmunicipalityblockspublic e /api/getmunicipalityedlvisitspublic — sind immer noch auf Sendung, mit dem gleichen Feedback wie immer.
Es müssen keine bestehenden Integrationen geändert werden. Die Migration wird nur denjenigen empfohlen, die die korrekten Feldnamen oder Blockdaten getrennt von Besuchen wünschen.
2026-07-30
Ländliche Ovitrap und Korrektur der epidemiologischen Woche
Nachricht
/api/postcounting begann zu akzeptieren ovitrap_type_id bei der Installation einer Ovitrap: 1 für Stadt (Standard, wenn das Feld nicht gesendet wird) und 2 für Land. Jeder andere Wert wird zurückgegeben 400 "Tipo de ovitrampa inválido".- Validierung der epidemiologischen Woche von
/api/postcounting e /api/postaction begann, Jahr und Woche miteinander zu vergleichen. Bisher konnte fälschlicherweise ein Datum aus einem zukünftigen Jahr mit einer geringen Wochenanzahl akzeptiert werden.
2026-07-28
Neue öffentliche Endpunkte für EDLs, Ovitraps und strategische Punkte
Nachricht
/api/getmunicipalityedlspublic — Von der Gemeinde registrierte EDLs./api/getmunicipalityovitrapspublic — registrierte Ovitraps mit Koordinaten und durchschnittlicher Anzahl Eier./api/getmunicipalityplacespublic — strategische Punkte, mit Typ, Untertyp und Gebiet.- Jeder akzeptiert
country, state, municipality e page, wie andere öffentliche Endpunkte.
2026-04-23
Besuche in Blöcken senden
Nachricht
- Neu
/api/postaction — protokolliert eine Besichtigung mit den bearbeiteten Grundstücken und den gefundenen Ablagerungen nach Klassen (a1, a2, b, c, d1, d2, e). - Senden
block_group_id anstatt block_id, Der Block wird automatisch innerhalb der Schlüsselgemeinde erstellt. - Konkrete Antworten:
403 wenn der Block aus einer anderen Gemeinde stammt und 409 wenn für diesen Block, dieses Jahr und diese Woche bereits ein Besuch vorliegt.
2026-03-27
Der Schlüssel wird nun aus der URL gelesen
Verhaltensänderung
Auf allen privaten Endpunkten ist die key Es wurde begonnen, ausschließlich aus der Abfragezeichenfolge zu lesen (?key=SUA_CHAVE), auch in POST. Integrationen, die nur den Schlüssel im Formularkörper gesendet haben, beginnen mit dem Empfang 404 "Wrong key" — Verschieben Sie einfach den Schlüssel zur URL und behalten Sie die anderen Felder im Textkörper bei.
2026-02-24
Entfernung von Besuchen und Sperren
Nachricht
/api/postdeleteaction — Entfernt den Besuch aus einem Block, identifiziert durch block_group_id e date./api/postdeleteblock — Entfernen Sie den Block.
2026-02-04
In privaten Zählungen nach Zeitraum filtern
Nachricht
/api/lastcounting begann zu akzeptieren date_start e date_end, So können Sie die Zählungen nach Datumsbereich reduzieren, anstatt jede Seite durchblättern zu müssen.
2025-10-19
Inkrementelle Synchronisierung öffentlicher Zählungen
Nachricht
/api/lastcountingpublic begann zu akzeptieren id (nur Vorkommen von diesem Bezeichner), date (Aufnahmedatum) e date_collect (data de coleta). Mit diesen Filtern können Sie eine gespiegelte Basis beibehalten, ohne Ihren gesamten Verlauf herabzustufen.
2025-03-18
In öffentlichen Zählungen nach Zeitraum filtern
Nachricht
/api/lastcountingpublic begann zu akzeptieren date_start e date_end.
2025-03-06
Entfernung der Ovitrap
Nachricht
/api/postdeleteovitrap — Entfernt eine Ovitrap aus dem ovitrap_group_id, innerhalb der Gemeinde Chave.