设备注册¶

注册子设备身份¶

上行

请求 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	设备数量超过单个产品下允许的最大值。