动态注册子设备

更新时间:
复制为 MD 格式

子设备的MQTT动态注册

  • 请求Topic:/sys/${productKey}/${deviceName}/thing/sub/register

  • 响应Topic:/sys/${productKey}/${deviceName}/thing/sub/register_reply

请求数据格式:

{
  "id": "123",
  "version": "1.0",
  "sys":{
      "ack":0
  },
  "params": [
    {
      "deviceName": "deviceName1234",
      "productKey": "a1234******"
    }
  ],
  "method": "thing.sub.register"
}

响应数据格式:

{
  "id": "123",
  "code": 200,
  "data": [
    {
      "iotId": "12344",
      "productKey": "a1234******",
      "deviceName": "deviceName1234",
      "deviceSecret": "xxxxxx"
    }
  ]
}

请求参数说明:

参数

类型

说明

id

String

消息ID号。String类型的数字,取值范围0~4294967295,且每个消息ID在当前设备中具有唯一性。

version

String

协议版本号,目前协议版本号唯一取值为1.0。

sys

Object

扩展功能的参数,其下包含各功能字段。

说明

使用设备端SDK开发时,如果未设置扩展功能,则无此参数,相关功能保持默认配置。

ack

Integer

sys下的扩展功能字段,表示是否返回响应数据。

  • 1:云端返回响应数据。

  • 0:云端不返回响应数据。

重要

如果未配置该功能,则无此参数,云端默认返回响应数据

params

List

子设备动态注册的参数。

deviceName

String

子设备的唯一ID。

productKey

String

子设备的产品ID。产品ID必须先创建

method

String

请求方法,取值thing.sub.register

响应参数说明:

参数

类型

说明

id

String

消息ID,String类型的数字,取值范围0~4294967295,且每个消息ID在当前设备中具有唯一性。

code

Integer

返回结果,200代表成功。

data

List<Object>

请求成功时返回的子设备信息,具体参数请参见下表data。

参数

类型

说明

deviceName

String

子设备的设备名称。

productKey

String

子设备所属产品的ProductKey。

iotId

String

平台分配的是设备唯一标识ID

deviceSecret

String

设备密钥

错误码说明如下表。

错误码

消息

描述

460

request parameter error

请求参数错误。

6402

topo relation cannot add by self

设备不能将自己添加为自己的子设备。

401

request auth error

签名校验失败。