互換性ポリシー
API には URL のバージョン管理がありません。代わりに、すでに運用環境にある統合が警告なしに動作を停止しないように、次の 3 つのルールに従います。
- 新しい動作では新しい URL が取得されます。 データ形式が変更されると、古いエンドポイントは以前とまったく同じように応答し続け、変更は逆方向に行われます。
- フィールドはいつでも追加できます。 答えをオープンなオブジェクトとして扱います。わからないことは壊さずに無視してください。
- 廃止されたエンドポイントはオンラインのままです。 彼らは参照を残しますが、応答を続けます。以下のリストは、それぞれの置き換えを示しています。
変更について質問がありますか、または移行に期限が必要ですか?書き込み先 contaovosdengue@gmail.com.
廃止されたエンドポイント
これらはすべて引き続き動作し、以前とまったく同じ内容を返します。新しいフィールドを受け取らないだけです。
| 終点 | 所定の位置で使用する | 理由 |
|---|
/api/getmunicipalityblockspublic | /api/getmunicipalityblocksvisitpublic | 名前にはブロックと書かれていましたが、リターンは常にブロックへの訪問によって得られました。 |
/api/getmunicipalityedlvisitspublic | /api/getmunicipalityedlmaintenancepublic | EDL は訪問ではなくメンテナンスを受けます。畑はから来ました edl_visit_* に edl_maintenance_*. |
変更履歴
2026-09-11
Datas e coordenadas impossíveis passam a ser recusadas
行動の変化
- 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
ニュース
- 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
ブロックの正しい名前と EDL メンテナンス
ニュース中止
- 新しい
/api/getmunicipalityblocksvisitpublic — 訪問はブロック単位で実行され、訪問ごとに 1 つのレコードが記録されます。旧版と同じ内容 /api/getmunicipalityblockspublic, 今では正しい名前が付けられています。 - 新しい
/api/getmunicipalityblockspublic-2 — ブロック自体、ブロックごとに 1 つのレコード、ポリゴン、タイプごとのプロパティの合計、および平均シェア。 - 新しい
/api/getmunicipalityedlmaintenancepublic — EDL メンテナンス。フィールドの名前が から変更されました。 edl_visit_* に edl_maintenance_*. - 製造中止
/api/getmunicipalityblockspublic e /api/getmunicipalityedlvisitspublic — はまだ放送中で、いつもと同じフィードバックが寄せられています。
既存の統合を変更する必要はありません。移行は、正しいフィールド名またはブロック データを訪問から分離したい場合にのみ推奨されます。
2026-07-30
農村部の卵トラップと疫学週の修正
ニュース
/api/postcounting 受け入れ始めた ovitrap_type_id オビトラップを設置する場合: 都市部では 1 (標準、フィールドが送信されない場合)、地方では 2。他の値は返されます 400 "Tipo de ovitrampa inválido".- 疫学週の検証
/api/postcounting e /api/postaction 年と週を一緒に比較し始めました。以前は、週数が少ない将来の年の日付が誤って受け入れられる可能性がありました。
2026-07-28
EDL、オビトラップ、および戦略的ポイントの新しいパブリック エンドポイント
ニュース
/api/getmunicipalityedlspublic — 自治体ごとに登録されたEDL。/api/getmunicipalityovitrapspublic — 登録されたオビトラップ、座標と卵の平均数。/api/getmunicipalityplacespublic — タイプ、サブタイプ、エリアを含む戦略的ポイント。- 誰もが受け入れます
country, state, municipality e page, 他のパブリック エンドポイントと同様に。
2026-04-23
ブロック単位で訪問を送信する
ニュース
- 新しい
/api/postaction — 作業中の不動産の訪問とクラスごとに見つかった預金を記録します。 (a1, a2, b, c, d1, d2, e). - 送信中
block_group_id の代わりに block_id, ブロックは主要自治体内に自動的に作成されます。 - 具体的な回答:
403 他の自治体のブロックの場合 409 そのブロック、年、週にすでに訪問がある場合。
2026-03-27
キーが URL から読み取られるようになりました
行動の変化
すべてのプライベート エンドポイントで、 key クエリ文字列から排他的に読み取られるようになりました (?key=SUA_CHAVE), POSTも含めて。フォーム本文でキーを送信しただけの統合は受信を開始します 404 "Wrong key" — 他のフィールドは本文に残したまま、キーを URL に移動するだけです。
2026-02-24
訪問とブロックの削除
ニュース
/api/postdeleteaction — によって識別されるブロックから訪問を削除します。 block_group_id e date./api/postdeleteblock — ブロックを外します。
2026-02-04
プライベートカウントの期間でフィルタリングする
ニュース
/api/lastcounting 受け入れ始めた date_start e date_end, すべてのページをスクロールする代わりに、日付範囲ごとにカウントを切り取ることができます。
2025-10-19
公開カウントの差分同期
ニュース
/api/lastcountingpublic 受け入れ始めた id (その識別子からの出現のみ), date (収録日) e date_collect (data de coleta). これらのフィルターを使用すると、履歴全体をダウングレードすることなく、ミラーリングされたベースを維持できます。
2025-03-18
公開カウントの期間でフィルタリングする
ニュース
/api/lastcountingpublic 受け入れ始めた date_start e date_end.
2025-03-06
オビトラップの除去
ニュース
/api/postdeleteovitrap — からオビトラップを除去します ovitrap_group_id, チャーベの自治体内。