# 查询设备组信息
接口应在服务器端调用,详细说明参见服务端API。
# 接口说明
# 接口英文名
getIotGroupInfo
# 功能描述
本接口用于查询设备组的信息。
# 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/wxa/business/group/getinfo?access_token=ACCESS_TOKEN
# 请求参数
属性 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 接口调用凭证,该参数为 URL 参数,非 Body 参数。使用access_token |
group_id | string | 是 | 设备组的唯一标识 |
# 返回参数
属性 | 类型 | 说明 | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
errcode | number | 错误码 | |||||||||||||
errmsg | string | 错误信息 | |||||||||||||
group_name | string | 设备名称 | |||||||||||||
device_list | array<object> | 设备列表 | |||||||||||||
| |||||||||||||||
model_id | string | 设备型号的唯一标识 | |||||||||||||
model_type | string | 设备类型 |
# 调用示例
示例说明: HTTPS请求示例
# 请求数据示例
{
"group_id": "GROUP_ID"
}
# 返回数据示例
{
"errcode": 0,
"errmsg": "ok",
"group_name": "GROUP_NAME",
"model_id": "MODEL_ID",
"model_type": "门禁机",
"device_list": [
{
"model_id": "MODEL_ID1",
"sn": "SN1"
},
{
"model_id": "MODEL_ID2",
"sn": "SN2"
}
]
}
# 错误码
错误码 | 错误码取值 | 解决方案 |
---|---|---|
43002 | require POST method | 方法调用错误,请用 post 方法调用 |
44002 | empty post data | POST 的数据包为空。post请求body参数不能为空。 |
47001 | data format error | 解析 JSON/XML 内容错误;post 数据中参数缺失;参数需以 JSON 字符串格式写在post请求的 body 中,请检查修正后重试 |
9800013 | group_id不合法 | 检查group_id |