设备注册¶
注册子设备身份¶
上行
请求 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 |
设备数量超过单个产品下允许的最大值。 |