Conta Ovos API

直接从您的系统咨询和发送产卵器、阻断和现场访问数据。此页面记录了所有可用的公共和专用端点。

/zh-tw/api请求 API 密钥

关于API

该API有端点 公共和私人. 公共 API 会随着时间的推移返回每个参与城市的纬度、经度和鸡蛋数量数据，而无需进行身份验证。仅建议与 Conta Ovos 合作的应用程序使用私有 API，因为它会公开敏感数据并允许您插入、更改和删除记录。

身份验证和密钥

要使用私有 API，您需要一个访问密钥 (key). 如需购买，请发送电子邮件至 contaovosdengue@gmail.com 陈述：

  • 为什么需要 API 访问；
  • 需要什么级别的访问权限（市、地区、州或国家）；
  • 您属于哪个地理区域？

密钥由以下部分组成 45 个随机字母 并且必须在参数中发送 key 每个私人请求。与关键相关的地理范围和规划 (api_access_municipality_id, state_id, region_id, country_id, plan) 自动定义它可以读取或更改哪些记录 - 例如，市政密钥只能读取或修改市政当局本身的数据。

将密钥发送到哪里： a key 始终从 URL 查询字符串中读取 (?key=SUA_CHAVE), 包括 POST 端点。仅在表单正文中发送它会导致 404 "Wrong key". 其他 POST 字段继续出现在请求正文中。
分页： 参数 page 在支持分页的端点上最多接受 100 个。无效或缺失值占据第 1 页。

响应代码

所有端点都遵循相同的 HTTP 状态模式：

代码意义
200请求处理成功。
400强制参数缺失或格式无效。
403通知的资源不属于所使用的密钥的范围（城市/州/地区）。
404密钥无效 (Wrong key) 或未找到资源。
409此标识符、年份和周组合的记录已存在。
500处理请求时发生内部错误。

公共端点

GET/api/lastcountingpublic民众

最新发布数量

返回按地点（城市、州或国家）发布的最新计数，以及鸡蛋数量和产卵器数据。

参数

姓名类型描述
statestring州代码。例子： state=RJ.
municipalitystring市镇名称。例子： municipality=Ponta Pora
countrystring国家名称。例子： country=Brasil. 如果省略，则假定为“巴西”。
pageint分页页（默认 1，最大 100）。
idint仅显示给定 ID 中出现的情况。例子： id=7876.
datedate显示自包含之日起发生的事件。例子： date=2025-01-01.
date_collectdate显示从收集日期开始发生的事件。例子： date_collect=2024-12-12.
date_startdate过滤计数的开始日期。例子： date_start=2025-01-01.
date_enddate过滤计数的结束日期。例子： date_end=2025-12-31.

笔记： 如果未发送位置参数，终端将返回来自巴西的最新计数。

具体答复：
  • 400 — 当发送的任何日期不符合格式时 YYYY-MM-DD. 响应中包含无效字段列表 invalid_fields.

请求示例

curl -G -d "municipality=Ponta%20Pora" \
  /zh-tw/api/lastcountingpublic

curl -G -d "state=MG" \
  /zh-tw/api/lastcountingpublic

答案示例

[
  {
    "state_name": "Minas Gerais",
    "state_code": "MG",
    "municipality": "Ponta Pora",
    "municipality_code": "5006606",
    "eggs": 42,
    "week": 3,
    "year": 2025,
    "time": "2025-01-20 14:32:10",
    "counting_id": 118342,
    "ovitrap_website_id": 981,
    "ovitrap_id": "97",
    "latitude": -7.000000,
    "longitude": -8.000000,
    "date": "2025-01-20",
    "date_collect": "2025-01-27"
  }
]
GET/api/getmunicipalityblocksvisitpublic民众

街区访问

返回按块进行的访问（治疗操作）的数据 — 每次访问一行，而不是每个块。

参数

姓名类型描述
statestring州代码。例子： state=RJ.
municipalitystring市镇名称。例子： municipality=Ponta Pora
countrystring国家名称。例子： country=Brasil. 如果省略，则假定为“巴西”。
pageint分页页（默认 1，最大 100）。

请求示例

curl -G -d "municipality=Vista%20Alegre" \
  /zh-tw/api/getmunicipalityblocksvisitpublic

curl -G -d "state=MS" \
  /zh-tw/api/getmunicipalityblocksvisitpublic

答案示例

[
  {
    "block_id": 4521,
    "block_actions_mean": 3.4,
    "block_coordinates": "[[-7.123, -34.845], [-7.124, -34.846]]",
    "municipality": "Vista Alegre",
    "municipality_code": "5007117",
    "state_name": "Mato Grosso do Sul",
    "state_code": "MS",
    "action_land_total_total": 21,
    "action_land_residence_total": 10,
    "action_land_commercial_total": 5,
    "action_land_empty_total": 3,
    "action_land_strategy_total": 1,
    "action_land_another_total": 2,
    "action_address_district": "Centro",
    "action_address_sector": "Setor 04",
    "action_deposit_a1_quantity": 4,
    "action_deposit_a2_quantity": 2,
    "action_deposit_b_quantity": 5,
    "action_deposit_c_quantity": 1,
    "action_deposit_d1_quantity": 0,
    "action_deposit_d2_quantity": 3,
    "action_deposit_e_quantity": 0,
    "action_observation": "Foco encontrado em pneus nos fundos do imovel.",
    "latitude": -7.123456,
    "longitude": -34.845678
  }
]
GET/api/getmunicipalityblockspublic-2民众

注册街区

返回在市政府注册的街区 — 每个街区一行，包含多边形、按类型划分的总属性和平均股数。

新端点。 如果您正在寻找分块进行的访问，请使用 /api/getmunicipalityblocksvisitpublic. 由于它是公共端点，因此响应不包括负责块或用户/团队标识符的代理。

参数

姓名类型描述
statestring州代码。例子： state=RJ.
municipalitystring市镇名称。例子： municipality=Ponta Pora
countrystring国家名称。例子： country=Brasil. 如果省略，则假定为“巴西”。
pageint分页页（默认 1，最大 100）。

请求示例

curl -G -d "municipality=Alta%20Floresta" \
  /zh-tw/api/getmunicipalityblockspublic-2

curl -G -d "state=MT" \
  /zh-tw/api/getmunicipalityblockspublic-2

答案示例

[
  {
    "block_id": 118342,
    "block_group_id": "1",
    "block_datetime": "Mon, 09 Sep 2024 10:12:41 GMT",
    "latitude": -9.849042,
    "longitude": -56.065069,
    "block_coordinates": "[{\"lat\":-9.849042,\"lng\":-56.065069}, ...]",
    "block_address_district": "DISTRITO INDUSTRIAL",
    "block_address_sector": "DISTRITO INDUSTRIAL",
    "block_municipality_id": 5566,
    "block_active": 1,
    "block_actions_mean": 22,
    "block_land_total": 24,
    "block_land_residence": 18,
    "block_land_commercial": 4,
    "block_land_empty": 2,
    "block_land_strategy": 0,
    "block_land_another": 0,
    "municipality": "Alta Floresta",
    "municipality_code": "5100250",
    "state_name": "Mato Grosso",
    "state_code": "MT"
  }
]
GET/api/getmunicipalityedlspublic民众

注册 EDL

从市政府注册的 EDL（从代理处定期维护的战略点）返回数据。

参数

姓名类型描述
statestring州代码。例子： state=RJ.
municipalitystring市镇名称。例子： municipality=Ponta Pora
countrystring国家名称。例子： country=Brasil. 如果省略，则假定为“巴西”。
pageint分页页（默认 1，最大 100）。

请求示例

curl -G -d "municipality=Vista%20Alegre" \
  /zh-tw/api/getmunicipalityedlspublic

curl -G -d "state=MS" \
  /zh-tw/api/getmunicipalityedlspublic

答案示例

[
  {
    "edl_id": 1832,
    "edl_group_id": "104",
    "edl_address_datetime": "2025-02-11 09:15:00",
    "edl_lat": -7.123456,
    "edl_lng": -34.845678,
    "edl_municipality_id": 5007117,
    "group_id": 12,
    "user_id": 348,
    "edl_responsable_agent": "João da Silva",
    "edl_block_group_id": "12",
    "edl_responsable_home": "Maria Souza",
    "edl_date": "2025-02-11",
    "edl_water_mean": 1.8,
    "municipality": "Vista Alegre",
    "municipality_code": "5007117",
    "state_name": "Mato Grosso do Sul",
    "state_code": "MS"
  }
]
GET/api/getmunicipalityedlmaintenancepublic民众

EDL维护

返回有关 EDL 上执行的维护的数据，包括每次维护期间记录的观察结果。

取代/api/getmunicipalityedlvisitspublic. EDL 接受维护，而不是访问——田地已经从 edl_visit_* 到 edl_maintenance_*. 旧 URL 继续工作并继续返回旧名称，以免破坏生产中的集成，但它已停止。

参数

姓名类型描述
statestring州代码。例子： state=RJ.
municipalitystring市镇名称。例子： municipality=Ponta Pora
countrystring国家名称。例子： country=Brasil. 如果省略，则假定为“巴西”。
pageint分页页（默认 1，最大 100）。

请求示例

curl -G -d "municipality=Vista%20Alegre" \
  /zh-tw/api/getmunicipalityedlmaintenancepublic

curl -G -d "state=MS" \
  /zh-tw/api/getmunicipalityedlmaintenancepublic

答案示例

[
  {
    "edl_maintenance_id": 9021,
    "edl_id": 1832,
    "edl_maintenance_time_week": 7,
    "edl_maintenance_time_year": 2025,
    "edl_maintenance_datetime": "2025-02-11 09:20:00",
    "edl_maintenance_user_id": 348,
    "edl_maintenance_observation": "Sem foco encontrado no local.",
    "edl_maintenance_observation_id": 3,
    "edl_maintenance_water_level": 0.5,
    "edl_maintenance_lat": -7.123456,
    "edl_maintenance_lng": -34.845678,
    "edl_maintenance_municipality_id": 5007117,
    "edl_maintenance_region_id": 4,
    "edl_maintenance_state_id": 24,
    "edl_maintenance_country_id": 1,
    "edl_maintenance_date": "2025-02-11",
    "edl_maintenance_observation_name": "Sem foco",
    "edl_maintenance_observation_number": 3,
    "municipality": "Vista Alegre",
    "municipality_code": "5007117",
    "state_name": "Mato Grosso do Sul",
    "state_code": "MS"
  }
]
GET/api/getmunicipalityovitrapspublic民众

注册产卵器

返回来自市政府注册的产卵器（卵监测点）的数据。

参数

姓名类型描述
statestring州代码。例子： state=RJ.
municipalitystring市镇名称。例子： municipality=Ponta Pora
countrystring国家名称。例子： country=Brasil. 如果省略，则假定为“巴西”。
pageint分页页（默认 1，最大 100）。

请求示例

curl -G -d "municipality=Vista%20Alegre" \
  /zh-tw/api/getmunicipalityovitrapspublic

curl -G -d "state=MS" \
  /zh-tw/api/getmunicipalityovitrapspublic

答案示例

[
  {
    "ovitrap_id": 4471,
    "ovitrap_group_id": "97",
    "ovitrap_datetime": "2025-01-20 14:32:10",
    "ovitrap_lat": -7.123456,
    "ovitrap_lng": -34.845678,
    "ovitrap_lat_lng_error": 0,
    "ovitrap_municipality_id": 5007117,
    "group_id": 12,
    "user_id": 348,
    "ovitrap_eggs_mean": 12.5,
    "ovitrap_block_id": 4521,
    "municipality": "Vista Alegre",
    "municipality_code": "5007117",
    "state_name": "Mato Grosso do Sul",
    "state_code": "MS"
  }
]
GET/api/getmunicipalityplacespublic民众

房产 (places)

返回按市镇登记的房产（战略点和特殊房产）。

参数

姓名类型描述
statestring州代码。例子： state=RJ.
municipalitystring市镇名称。例子： municipality=Ponta Pora
countrystring国家名称。例子： country=Brasil. 如果省略，则假定为“巴西”。
pageint分页页（默认 1，最大 100）。

请求示例

curl -G -d "municipality=Vista%20Alegre" \
  /zh-tw/api/getmunicipalityplacespublic

curl -G -d "state=MS" \
  /zh-tw/api/getmunicipalityplacespublic

答案示例

[
  {
    "place_id": 771,
    "user_id": 348,
    "place_address_district": "Centro",
    "place_address_sector": "Setor 04",
    "place_datetime": "2025-02-05 10:00:00",
    "place_address_lat": -7.123456,
    "place_address_lng": -34.845678,
    "place_municipality_id": 5007117,
    "place_region_id": 4,
    "place_state_id": 24,
    "place_country_id": 1,
    "place_type_id": 2,
    "place_name": "Ferro-velho Bom Preço",
    "place_coordinates": "[[-7.123, -34.845], [-7.124, -34.846]]",
    "place_subtype": 5,
    "place_area": 320.5,
    "municipality": "Vista Alegre",
    "municipality_code": "5007117",
    "state_name": "Mato Grosso do Sul",
    "state_code": "MS"
  }
]

私有端点

以下所有端点都需要该参数 key 使用您的 API 密钥。

GET/api/lastcounting私人的

最新发布数量

返回在键范围内释放的最后计数，包括鸡蛋数量、产卵器数据和负责的用户。

参数

姓名类型描述
keystring您的 API 密钥。定义返回计数的范围。
pageint分页页（默认 1，最大 100）。
date_startdate过滤计数的开始日期。例子： date_start=2025-01-01.
date_enddate过滤计数的结束日期。例子： date_end=2025-12-31.
具体答复：
  • 400 — 当发送的任何日期不符合格式时 YYYY-MM-DD. 响应中包含无效字段列表 invalid_fields.

请求示例

curl -G -d "key=KEY&page=1" \
  /zh-tw/api/lastcounting

答案示例

[
  {
    "state_name": "Minas Gerais",
    "state_code": "MG",
    "municipality": "Ponta Pora",
    "municipality_code": "5006606",
    "eggs": 42,
    "week": 3,
    "year": 2025,
    "time": "2025-01-20 14:32:10",
    "user": "Joao da Silva",
    "counting_id": 118342,
    "ovitrap_website_id": 981,
    "ovitrap_id": "97",
    "district": "Centro",
    "street": "Rua das Flores",
    "number": "123",
    "complement": "",
    "loc_inst": "",
    "sector": "Setor 04",
    "latitude": -7.000000,
    "longitude": -8.000000,
    "date": "2025-01-20",
    "date_collect": "2025-01-27"
  }
]
GET/api/getmunicipalityedls私人的

注册 EDL

从键的地理范围内的 EDL（代理定期访问的战略点）返回数据。范围由与关键（市、地区、州或国家）相关的计划自动定义，无需在请求中告知市、州或国家。

参数

姓名类型描述
keystring您的 API 密钥。定义返回的 EDL 的地理范围。
pageint分页页（默认 1，最大 100）。

请求示例

curl -G -d "key=KEY&page=1" \
  /zh-tw/api/getmunicipalityedls

答案示例

[
  {
    "edl_id": 1832,
    "edl_group_id": "104",
    "edl_address_datetime": "2025-02-11 09:15:00",
    "edl_lat": -7.123456,
    "edl_lng": -34.845678,
    "edl_municipality_id": 5007117,
    "group_id": 12,
    "user_id": 348,
    "edl_responsable_agent": "João da Silva",
    "edl_block_group_id": "12",
    "edl_responsable_home": "Maria Souza",
    "edl_date": "2025-02-11",
    "edl_water_mean": 1.8,
    "municipality": "Vista Alegre",
    "municipality_code": "5007117",
    "state_name": "Mato Grosso do Sul",
    "state_code": "MS"
  }
]
GET/api/getmunicipalityedlvisits私人的

EDL维护

注意：来自此专用端点的响应字段以前缀继续 edl_visit_*. 只有等效的公共端点开始使用 edl_maintenance_*.

返回在关键的地理范围内对 EDL 进行的访问的数据，包括每次访问记录的观察结果。范围由与关键（市、地区、州或国家）相关的计划自动定义，无需在请求中告知市、州或国家。

参数

姓名类型描述
keystring您的 API 密钥。定义回访的地理范围。
pageint分页页（默认 1，最大 100）。

请求示例

curl -G -d "key=KEY&page=1" \
  /zh-tw/api/getmunicipalityedlvisits

答案示例

[
  {
    "edl_visit_id": 9021,
    "edl_id": 1832,
    "edl_visit_time_week": 7,
    "edl_visit_time_year": 2025,
    "edl_visit_datetime": "2025-02-11 09:20:00",
    "edl_visit_user_id": 348,
    "edl_visit_observation": "Sem foco encontrado no local.",
    "edl_visit_observation_id": 3,
    "edl_visit_water_level": 0.5,
    "edl_visit_lat": -7.123456,
    "edl_visit_lng": -34.845678,
    "edl_visit_municipality_id": 5007117,
    "edl_visit_region_id": 4,
    "edl_visit_state_id": 24,
    "edl_visit_country_id": 1,
    "edl_visit_date": "2025-02-11",
    "edl_visit_observation_name": "Sem foco",
    "edl_visit_observation_number": 3,
    "municipality": "Vista Alegre",
    "municipality_code": "5007117",
    "state_name": "Mato Grosso do Sul",
    "state_code": "MS"
  }
]
GET/api/getmunicipalityblocks私人的

Visitas em quarteirões

返回在键的地理范围内分块执行的操作（治疗就诊）的数据。范围由与关键（市、地区、州或国家）相关的计划自动定义，无需在请求中告知市、州或国家。

参数

姓名类型描述
keystring您的 API 密钥。定义返回操作的地理范围。
pageint分页页（默认 1，最大 100）。

请求示例

curl -G -d "key=KEY&page=1" \
  /zh-tw/api/getmunicipalityblocks

答案示例

[
  {
    "block_id": 4521,
    "block_actions_mean": 3.4,
    "block_coordinates": "[[-7.123, -34.845], [-7.124, -34.846]]",
    "municipality": "Vista Alegre",
    "municipality_code": "5007117",
    "state_name": "Mato Grosso do Sul",
    "state_code": "MS",
    "action_land_total_total": 21,
    "action_land_residence_total": 10,
    "action_land_commercial_total": 5,
    "action_land_empty_total": 3,
    "action_land_strategy_total": 1,
    "action_land_another_total": 2,
    "action_address_district": "Centro",
    "action_address_sector": "Setor 04",
    "action_deposit_a1_quantity": 4,
    "action_deposit_a2_quantity": 2,
    "action_deposit_b_quantity": 5,
    "action_deposit_c_quantity": 1,
    "action_deposit_d1_quantity": 0,
    "action_deposit_d2_quantity": 3,
    "action_deposit_e_quantity": 0,
    "action_observation": "Foco encontrado em pneus nos fundos do imovel.",
    "latitude": -7.123456,
    "longitude": -34.845678
  }
]
GET/api/getmunicipalityovitraps私人的

注册产卵器

返回来自密钥地理范围内的产卵器（虫卵监测点）的数据。范围由与关键（市、地区、州或国家）相关的计划自动定义，无需在请求中告知市、州或国家。

参数

姓名类型描述
keystring您的 API 密钥。设置返回的产卵器的地理范围。
pageint分页页（默认 1，最大 100）。

请求示例

curl -G -d "key=KEY&page=1" \
  /zh-tw/api/getmunicipalityovitraps

答案示例

[
  {
    "ovitrap_id": 4471,
    "ovitrap_group_id": "97",
    "ovitrap_datetime": "2025-01-20 14:32:10",
    "ovitrap_lat": -7.123456,
    "ovitrap_lng": -34.845678,
    "ovitrap_lat_lng_error": 0,
    "ovitrap_municipality_id": 5007117,
    "group_id": 12,
    "user_id": 348,
    "ovitrap_eggs_mean": 12.5,
    "ovitrap_block_id": 4521,
    "municipality": "Vista Alegre",
    "municipality_code": "5007117",
    "state_name": "Mato Grosso do Sul",
    "state_code": "MS"
  }
]
GET/api/getmunicipalityplaces私人的

房产 (places)

返回密钥地理范围内的房产（战略点和特殊房产）。范围由与密钥关联的套餐自动确定——市镇、区域、州或国家——因此请求中无需指明市镇、州或国家。

参数

姓名类型描述
keystring您的 API 密钥。定义返回点的地理范围。
pageint分页页（默认 1，最大 100）。

请求示例

curl -G -d "key=KEY&page=1" \
  /zh-tw/api/getmunicipalityplaces

答案示例

[
  {
    "place_id": 771,
    "user_id": 348,
    "place_address_district": "Centro",
    "place_address_sector": "Setor 04",
    "place_datetime": "2025-02-05 10:00:00",
    "place_address_lat": -7.123456,
    "place_address_lng": -34.845678,
    "place_municipality_id": 5007117,
    "place_region_id": 4,
    "place_state_id": 24,
    "place_country_id": 1,
    "place_type_id": 2,
    "place_name": "Ferro-velho Bom Preço",
    "place_coordinates": "[[-7.123, -34.845], [-7.124, -34.846]]",
    "place_subtype": 5,
    "place_area": 320.5,
    "municipality": "Vista Alegre",
    "municipality_code": "5007117",
    "state_name": "Mato Grosso do Sul",
    "state_code": "MS"
  }
]
POST/api/postcounting私人的

阅读提交内容

发送产卵器的读数。可以将数据发送到现有的产卵器，或者在发送数据的同时安装新的产卵器。

参数

姓名类型描述
keystring您的 API 密钥。定义提交的范围。

请求示例

curl -X POST \
  "/zh-tw/api/postcounting?key=KEY"

对于标准运输，无需安装新的产卵器，请发送以下字段 (全部强制) 在请求正文中 (form):

{
  "ovitrap_group_id": 97,
  "ovitrap_lat": -7.000000,
  "ovitrap_lng": -8.000000,
  "date": "2025-01-20",
  "counting_observation_id": 1,
  "counting_observation": "caso o counting_observation_id seja 9",
  "counting_eggs": 5
}

包含每种观察类型的 ID 的表格 (counting_observation_id):

ID意义
1没有观察结果
2安装和收集之间的间隔比预期长
3产卵器或缺少调色板
4产卵器或损坏的调色板
5产卵器或调色板已移除
6干式产卵器
7封闭式房屋
8充满水的产卵器
9产卵器加少量水
10另一个观察

要在货物旁边安装新的产卵器， 强制的 字段： ovitrap_lat, ovitrap_lng, ovitrap_group_id

{
  "ovitrap_group_id": 96,
  "ovitrap_address_district": "Distrito",
  "ovitrap_address_street": "Rua",
  "ovitrap_address_number": "Numero",
  "ovitrap_address_complement": "Complemento",
  "ovitrap_address_loc_inst": "",
  "ovitrap_lat": -7.000000,
  "ovitrap_lng": -8.000000,
  "ovitrap_address_sector": "Setor",
  "ovitrap_responsable": "Responsavel",
  "ovitrap_block_id": "Quarteirao",
  "ovitrap_type_id": 1,
  "date": "2025-01-20",
  "counting_date_collect": "2025-01-27",
  "counting_observation_id": 1,
  "counting_observation": "caso o counting_observation_id seja 9",
  "counting_eggs": 5
}

包含每种类型诱蛋器 ID 的表格 (ovitrap_type_id): 将 1 只送到城市产卵器，2 只送到农村产卵器。 该字段是可选的，如果未发送，则产卵器将安装为城市：

ID意义
1城市诱产卵器 (标准)
2农村诱产卵器
具体答复：
  • 400 — 当未发送任何必填字段时： ovitrap_lat, ovitrap_lng, ovitrap_group_id, date
  • 400 — 当 ovitrap_type_id 发送的既不是 1 也不是 2。
  • 400 — 当发送的任何日期不符合格式时 YYYY-MM-DD. 响应中包含无效字段列表 invalid_fields.
  • 404 — 已经对这个诱产蛋器进行了年份和星期的计数。
POST/api/postdeletecounting私人的

删除读数

删除产卵器的读数。

参数

姓名类型描述
keystring您的 API 密钥。定义删除范围。

请求示例

curl -X POST \
  "/zh-tw/api/postdeletecounting?key=KEY"

请求正文中所需的数据 (form):

{
  "ovitrap_group_id": 97,
  "date": "2025-01-20"
}
具体答复：
  • 400 — 什么时候 date 未发送。
  • 400 — 当发送的任何日期不符合格式时 YYYY-MM-DD. 响应中包含无效字段列表 invalid_fields.
POST/api/postdeleteovitrap私人的

删除诱产卵器

移除诱产卵器。

参数

姓名类型描述
keystring您的 API 密钥。

请求示例

curl -X POST \
  "/zh-tw/api/postdeleteovitrap?key=KEY"

请求正文中所需的数据 (form):

{
  "ovitrap_group_id": 97
}
POST/api/postaction私人的

插入访问

在块中注册访问/操作。要将访问添加到现有块，请发送字段 block_id. 如果不存在，则使用 block_group_id — 系统会自动创建街区。此端点仅允许插入申请人所在城市内的块。

参数

姓名类型描述
keystring您的 API 密钥。

请求示例

curl -X POST \
  "/zh-tw/api/postaction?key=KEY"

数据已发送 form 或查询参数，使用 block_id:

{
  "block_id": 97,
  "date": "2025-01-20",
  "block_land_residence": 10,
  "action_land_residence_out": 2,
  "action_land_residence_breedings": 1,
  "action_land_residence_treated": 1,

  "block_land_commercial": 5,
  "action_land_commercial_out": 0,
  "action_land_commercial_breedings": 0,
  "action_land_commercial_treated": 0,

  "block_land_empty": 3,
  "action_land_empty_out": 1,
  "action_land_empty_breedings": 2,
  "action_land_empty_treated": 1,

  "block_land_strategy": 1,
  "action_land_strategy_out": 0,
  "action_land_strategy_breedings": 0,
  "action_land_strategy_treated": 0,

  "block_land_special": 0,
  "action_land_special_out": 0,
  "action_land_special_breedings": 0,
  "action_land_special_treated": 0,

  "block_land_another": 2,
  "action_land_another_out": 0,
  "action_land_another_breedings": 0,
  "action_land_another_treated": 0,

  "action_deposit_a1_quantity": 4,
  "action_deposit_a1_eliminated": 2,
  "action_deposit_a1_treated": 1,
  "action_deposit_a1_larvicid": 10,

  "action_deposit_a2_quantity": 2,
  "action_deposit_a2_eliminated": 1,
  "action_deposit_a2_treated": 0,
  "action_deposit_a2_larvicid": 0,

  "action_deposit_b_quantity": 5,
  "action_deposit_b_eliminated": 5,
  "action_deposit_b_treated": 0,
  "action_deposit_b_larvicid": 0,

  "action_deposit_c_quantity": 1,
  "action_deposit_c_eliminated": 0,
  "action_deposit_c_treated": 1,
  "action_deposit_c_larvicid": 5,

  "action_deposit_d1_quantity": 0,
  "action_deposit_d1_eliminated": 0,
  "action_deposit_d1_treated": 0,
  "action_deposit_d1_larvicid": 0,

  "action_deposit_d2_quantity": 3,
  "action_deposit_d2_eliminated": 1,
  "action_deposit_d2_treated": 2,
  "action_deposit_d2_larvicid": 15,

  "action_deposit_e_quantity": 0,
  "action_deposit_e_eliminated": 0,
  "action_deposit_e_treated": 0,
  "action_deposit_e_larvicid": 0,

  "action_observation": "Visita realizada conforme cronograma. Foco encontrado em pneus nos fundos do imovel."
}

选择 block_group_id （块尚未注册），还发送块本身的数据：

{
  "block_group_id": 97,
  "date": "2025-01-20",
  "block_address_district": "Centro Historico",
  "block_address_sector": "Setor 04 - Norte",
  "block_coordinates": "[[-7.123, -34.845], [-7.124, -34.846]]",
  "block_lat": -7.123456,
  "block_lng": -34.845678,
  "block_responsable": "Joao da Silva",

  "block_land_residence": 10,
  "action_land_residence_out": 2,
  "action_land_residence_breedings": 1,
  "action_land_residence_treated": 1,

  "block_land_commercial": 5,
  "action_land_commercial_out": 0,
  "action_land_commercial_breedings": 0,
  "action_land_commercial_treated": 0,

  "block_land_empty": 3,
  "action_land_empty_out": 1,
  "action_land_empty_breedings": 2,
  "action_land_empty_treated": 1,

  "block_land_strategy": 1,
  "action_land_strategy_out": 0,
  "action_land_strategy_breedings": 0,
  "action_land_strategy_treated": 0,

  "block_land_special": 0,
  "action_land_special_out": 0,
  "action_land_special_breedings": 0,
  "action_land_special_treated": 0,

  "block_land_another": 2,
  "action_land_another_out": 0,
  "action_land_another_breedings": 0,
  "action_land_another_treated": 0,

  "action_deposit_a1_quantity": 4,
  "action_deposit_a1_eliminated": 2,
  "action_deposit_a1_treated": 1,
  "action_deposit_a1_larvicid": 10,

  "action_deposit_a2_quantity": 2,
  "action_deposit_a2_eliminated": 1,
  "action_deposit_a2_treated": 0,
  "action_deposit_a2_larvicid": 0,

  "action_deposit_b_quantity": 5,
  "action_deposit_b_eliminated": 5,
  "action_deposit_b_treated": 0,
  "action_deposit_b_larvicid": 0,

  "action_deposit_c_quantity": 1,
  "action_deposit_c_eliminated": 0,
  "action_deposit_c_treated": 1,
  "action_deposit_c_larvicid": 5,

  "action_deposit_d1_quantity": 0,
  "action_deposit_d1_eliminated": 0,
  "action_deposit_d1_treated": 0,
  "action_deposit_d1_larvicid": 0,

  "action_deposit_d2_quantity": 3,
  "action_deposit_d2_eliminated": 1,
  "action_deposit_d2_treated": 2,
  "action_deposit_d2_larvicid": 15,

  "action_deposit_e_quantity": 0,
  "action_deposit_e_eliminated": 0,
  "action_deposit_e_treated": 0,
  "action_deposit_e_larvicid": 0,

  "action_observation": "Area com alta densidade de recipientes descartaveis."
}
具体答复：
  • 400 — 什么时候 date 未发送或当数字字段之一不是有效数字时。
  • 400 — 当发送的任何日期不符合格式时 YYYY-MM-DD. 响应中包含无效字段列表 invalid_fields.
  • 400 — 什么时候 block_group_id 创建新块时不会发送。
  • 403 — 当 block_id 通报不属于重点直辖市。
  • 409 — 当该街区、年份和周已经有访问时。
POST/api/postdeleteaction私人的

删除访问

从一个块中删除一次访问。

参数

姓名类型描述
keystring您的 API 密钥。

请求示例

curl -X POST \
  "/zh-tw/api/postdeleteaction?key=KEY"

请求正文中所需的数据 (form):

{
  "block_group_id": 97,
  "date": "2025-01-20"
}
具体答复：
  • 400 — 什么时候 date 未发送。
  • 400 — 当发送的任何日期不符合格式时 YYYY-MM-DD. 响应中包含无效字段列表 invalid_fields.
POST/api/postdeleteblock私人的

删除街区

移除一个街区。

参数

姓名类型描述
keystring您的 API 密钥。

请求示例

curl -X POST \
  "/zh-tw/api/postdeleteblock?key=KEY"

请求正文中所需的数据 (form):

{
  "block_group_id": 97
}