兼容性政策
API 没有 URL 版本控制。相反，我们遵循三个规则，以便生产中的集成不会在没有警告的情况下停止工作：
- 新行为获得新 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 — 访问分批进行，每次访问一条记录。内容与旧版相同 /api/getmunicipalityblockspublic, 现在有了正确的名字。 - 新的
/api/getmunicipalityblockspublic-2 — 块本身，每个块一条记录，具有多边形、按类型划分的总属性和平均份额。 - 新的
/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), 包括在帖子中。仅发送表单正文中的密钥的集成开始接收 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, 查韦市境内。