# 设备组扩容

调试工具

接口应在服务器端调用,详细说明参见服务端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