设备注册¶
注册子设备身份¶
上行
- 请求 TOPIC:
/sys/{productKey}/{deviceKey}/thing/device/register
- 响应 TOPIC:
/sys/{productKey}/{deivceKey}/thing/device/register_reply
请求数据格式¶
{
"method":"thing.device.register",
"id":"1",
"params":[
{
"timezone":"+08:00",
"deviceKey":"sample_dev_01",
"productKey":"aVpQQTDp",
"deviceAttributes":{
"location":"Shanghai",
"name":"dev_01"
},
"deviceName":{
"defaultValue":"sample_dev_01",
"i18nValue":{
"en_US":"eng_dev_01",
"zh_CN":"中文设备01"
}
},
"deviceDesc":"dev desc"
},
{
"timezone":"+09:00",
"deviceKey":"sample_dev_02",
"productKey":"aVpQQTDp",
"deviceAttributes":{
"location":"Beijing",
"name":"dev_01"
},
"deviceName":{
"defaultValue":"sample_dev_02",
"i18nValue":{
"en_US":"eng_dev_02",
"zh_CN":"中文设备02"
}
},
"deviceDesc":"dev desc"
}
],
"version":"1.1"
}
响应数据格式¶
{
"code":200,
"data":[
{
"deviceSecret":"yourDeviceSecret",
"assetId":"LOMCp6V2",
"deviceKey":"sample_dev_01",
"productKey":"aVpQQTDp"
},
{
"deviceSecret":"yourDeviceSecret",
"assetId":"8MGrcj2b",
"deviceKey":"sample_dev_02",
"productKey":"aVpQQTDp"
}
],
"id":"1"
}
请求参数说明¶
参数 | 类型 | 是否必需 | 说明 |
---|---|---|---|
id | String | 可选 | 消息 ID 号,保留值。 |
version | String | 必需 | 协议版本号,目前协议版本 1.0。 |
params | List | 必需 | 设备动态注册的参数。 |
deviceAttributes | String | 可选 | 设备的属性列。 |
deviceKey | String | 可选 | 子设备的 deviceKey。 |
deviceName | String | 可选 | 子设备的名字。 |
deviceDesc | String | 可选 | 子设备的描述。 |
productKey | String | 必需 | 子设备的 productKey。 |
assetId | String | 必需 | 设备的唯一标识符。 |
deviceSecret | String | 必需 | 子设备的 deviceSecret。 |
method | String | 必需 | 请求方法。 |
响应参数说明¶
参数 | 类型 | 说明 |
---|---|---|
code | Integer | 结果返回码,200 代表请求成功执行。 |
data | JSON | 返回的详细信息。JSON 格式。 |
结果返回码¶
返回码 | 错误消息 | 释义 |
---|---|---|
702 | DeviceKey existed | 自定义的 device key 已存在。 |
714 | Generate deviceKey failed | 自动生成 device key 失败。 |
739 | Exceed the product max device size | 设备数量超过单个产品下允许的最大值。 |