网关添加子设备
调用此接口,将子设备添加在网关下。
接口路径
/api/device/addTopo/{pk}/{devId}
请求方式
[PUT]
请求参数
路径参数:
参数名称 | 数据类型 | 是否必须 | 说明 |
---|---|---|---|
pk | String | 是 | 网关产品pk |
devId | String | 是 | 网关设备ID |
Headers:
参数名称 | 参数值 | 是否必须 |
---|---|---|
Authorization | {token} | 是 |
- 其中token获取方式参考使用AccessKey计算token。
Body:
参数名称 | 参数类型 | 是否必须 | 说明 |
---|---|---|---|
pk | String | 是 | 子设备产品pk |
devId | String | 是 | 子设备设备ID |
random | String | 否 | 用于计算sigh |
hashMethod | String | 否 | 加密方法,用于计算sigh |
sign | String | 否 | 鉴权签名,用于挂载需要鉴权校验的设备 |
【示例】:
{
"pk":"3cfb**********4d8233f7d",
"devId":"B01********0001"
}
【提示】只有登陆需要校验的设备需要填写random
,hashMethod
和sign
。(sign 计算方法与设备连接MQTT认证方式一致)
【示例】:
http://1*3.*9.*1.**2:8***/api/device/addTopo/1c50cf*******e2935f5468a5b/testdevid
返回参数
名称 | 类型 | 是否必须 | 说明 |
---|---|---|---|
action | String | 是 | 指令类型,此处为"addTopoResp",即添加拓扑返回值 |
msgId | number | 是 | 消息id |
pk | String | 是 | 网关产品PK |
devId | String | 是 | 网关设备ID |
code | number | 是 | 错误码 |
desc | String | 是 | 描述说明 |
sub.pk | String | 是 | 子设备产品pk |
sub.devId | String | 是 | 子设备设备ID |
【示例】:
{
"action": "addTopoResp",
"msgId": 0,
"pk": "1c50cf*******e2935f5468a5b",
"devId": "testdevid",
"code": 0,
"desc": "success",
"sub": {
"pk": "3cfbf*********d8233f7d",
"devId": "B0**********001"
}
}