请求方式: POST(HTTPS)
请求地址: https://qyapi.weixin.qq.com/cgi-bin/report/grid/update?access_token=ACCESS_TOKEN
请求包体:
{
"grid_id": "grid_id",
"grid_name": "grid_name",
"grid_parent_id" : "grid_id",
"grid_admin": ["zhangsan"],
"grid_member": ["lisi", "invaliduser"]
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证。“获取access_token” |
grid_id | 是 | 网格id |
grid_name | 是 | 网格名称,不能超过30个字,同一个目标网格下,不能存在同名的同级子网格 |
grid_parent_id | 是 | 父节点的id,网格结构层级最多支持10层 |
grid_admin | 是 | 网格「负责人」userid列表,每个网格至少1个,最多20个负责人 |
grid_member | 否 | 该节点的成员userid列表,不能超过100个,同一个成员最多能成功10个网格的管理员 ,为空则表示清空所有的成员 |
权限说明:
应用类型 | 权限要求 |
---|---|
自建应用 | 配置到「居民联系 - 可调用接口的应用」中 |
代开发应用 | 暂不支持 |
第三方应用 | 暂不支持 |
注: 从2023年12月1日0点起,不再支持通过系统应用secret调用接口,存量企业暂不受影响 查看详情
返回结果:
{
"errcode": 0,
"errmsg": "ok",
"invalid_userids": [
"invaliduser"
]
}
参数说明:
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |
invalid_userids | 不合法的userid |