API变更

Conta Ovos API 的历史变化（从最新到最旧），以及它们对于那些已经在生产中进行集成的人意味着什么。

/zh-mo/api返回参考

兼容性政策

API 没有 URL 版本控制。相反，我们遵循三个规则，以便生产中的集成不会在没有警告的情况下停止工作：

  • 新行为获得新 URL。 当数据格式发生变化时，旧端点继续像以前一样做出响应，而变化则相反。
  • 可以随时添加字段。 将答案视为一个开放的对象：忽略你不知道的东西，而不是破坏它。
  • 中断的端点仍保持在线状态。 他们留下了参考文献，但继续回复——下面的列表显示了每一个的替代品。
您对任何更改有疑问吗？或者您是否需要一个迁移截止日期？写信给 contaovosdengue@gmail.com.

终止的端点

它们都继续工作并返回与以前完全相同的内容。他们只是没有收到新的字段。

端点使用到位原因
/api/getmunicipalityblockspublic/api/getmunicipalityblocksvisitpublic名字叫“街区”，但回报总是来自对它们的访问。
/api/getmunicipalityedlvisitspublic/api/getmunicipalityedlmaintenancepublicEDL 接受维护，而不是上门；这些田地来自 edl_visit_* 到 edl_maintenance_*.

变更历史记录

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, 查韦市境内。