# 创建设备组
调试工具
接口应在服务器端调用，详细说明参见服务端API。
# 接口说明
# 接口英文名
createIotGroupId
# 功能描述
本接口用于创建设备组，便于用户一次性订阅多个设备
# 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/wxa/business/group/createid?access_token=ACCESS_TOKEN
# 请求参数
| 属性 | 类型 | 必填 | 说明 |
|---|
| access_token | string | 是 | 接口调用凭证，该参数为 URL 参数，非 Body 参数。使用access_token |
| model_id | string | 是 | 设备型号的唯一标识。 |
| group_name | string | 是 | 设备组的名称（创建时时决定，无法修改） |
# 返回参数
| 属性 | 类型 | 说明 |
|---|
| errcode | number | 错误码 |
| errmsg | string | 错误信息 |
| group_id | string | 设备组的唯一标识 |
# 其他说明
创建的设备组只能添加与传入 model_id 同一类型的设备。
# 调用示例
示例说明: HTTPS请求示例
# 请求数据示例
{
"group_name": "GROUP_NAME",
"model_id": "MODEL_ID"
}
# 返回数据示例
{
"errcode": 0,
"errmsg": "ok",
"group_id": "GROUP_ID"
}
# 错误码
| 错误码 | 错误码取值 | 解决方案 |
|---|
| 9800012 | group_name 不合法，长度应为 1-32 字节 | 检查 group_name 字段 |
| 47001 | data format error | 解析 JSON/XML 内容错误;post 数据中参数缺失;参数需以 JSON 字符串格式写在post请求的 body 中，请检查修正后重试 |
| 44002 | empty post data | POST 的数据包为空。post请求body参数不能为空。 |
| 43002 | require POST method | 方法调用错误，请用 post 方法调用 |
| 9800003 | model_id检查不通过 | 检查model_id |