# 设备组扩容
接口应在服务器端调用,详细说明参见服务端API。
# 接口说明
随着部分学校使用话机规模增加,50 台的设备组容量无法满足使用需求,造成使用不便(用户需多次授权、开发者需管理一所学校多个设备组)。因此,需提升设备组容量。
有如下使用要求:
- 设备组名称必须为明确的地点(如学校名称),不应仅包含模糊的位置或品牌等无法明确指定一定区域等名称,如广州市的校园话机,XX品牌的校园话机等。
- 目前支持将设备组容量扩充到 200个设备
- 微信团队保留封禁设备组的能力
# 接口英文名
expandGroup
# 功能描述
本接口用于创建大容量设备组,便于用户一次性订阅多个设备
# 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/wxa/business/group/expand?access_token=ACCESS_TOKEN
access_token 由该接口调用凭据获取.
# 请求参数
属性 | 类型 | 必填 | 说明 |
---|---|---|---|
group_id | string | 是 | 使用 createIotGroupId 创建的设备组唯一标识 |
max_device_count | number | 是 | 需要扩容到设备最大数量,目前仅支持填 200 |
province_name | string | 是 | 设备组所在省份名称 |
city_name | string | 是 | 设备组所在城市名称 |
# 返回参数
属性 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
group_id | string | 设备组的唯一标识 |
# 其他说明
# 调用示例
示例说明: HTTPS请求示例
# 请求数据示例
{
"group_id": "GROUP_ID",
"max_device_count": 200,
"province_name": "广东省",
"city_name": "广州市"
}
# 返回数据示例
{
"errcode": 0,
"errmsg": "ok",
"group_id": "GROUP_ID"
}
# 错误码
参考 createIotGroupId 的错误码及返回值中的 errmsg