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-09-11
Datas e coordenadas impossíveis passam a ser recusadas
Verhaltensänderung
- 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
Nachricht
- 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
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.