设备注册

接口说明

名称 版本 描述 设备激活前接口
tuya.device.register 4.0 向云端请求一个新的设备ID

注意: 调用该接口会生成全新设备id,仅供设备恢复出厂设置的场景下调用。

请求参数

  • 业务参数
名称 类型 描述 参数是否可选
productKey String 开发者平台对应的产品ID
hid String 硬件设备唯一标识,固件防拷贝需要填
  • 其他参数

请求示例

data参数:
{
"productKey": "开发者平台对应的产品ID",
"hid":"xxxxxxxxxxxxxxxx"
}

业务参数AES加密KEY

使用设备的授权authKey的前16个字符作为AES加密Key

请求签名KEY

使用设备的授权authKey进行签名

注意事项

千万不要重复调用本接口,只适用特定的调用场景:

  • 设备首次注册
  • 设备激活调用tuya.device.active返回**

    本接口返回的devId需要设备保存在非易失性存储器上,后续设备激活通过devId去进行激活,与云端的各种交互也通过devId。

    ## 组装URL示例

http://a.gw.tuyacn.com/gw.json?a=tuya.device.register&t=1487302413565&v=4.0&data=3D49F7E9128A3D6466CADDF31BE1EDBEA2F61E3F4643EDD0CB188D78C8EA716419B4078381818CB6F336810FA4E25BAA&uuid={设备唯一标识符,厂测前由涂鸦提供}&sign=7dc92a63b79a597127780d8a01f49d26


## 响应说明

| 名称 | 类型 | 描述 |
| ------------ | ------------- | ------------ |
| result | Map | 返回结果 |
| result.devId | String | 设备Id,与云端交互的标识符,每次注册都重新生成|
| t | String | 时间戳(单位:秒)|
| success | Boolean | 是否成功 |

## 响应示例

请求成功示例 { “result”: { “devId”: “6ca74974ab6f44c23c7T1r” }, “t”: 1457089806, “success”: true }

请求失败示例 result: { “t”: 1469534197, “errorCode”: “错误码”, “errorMsg”: “错误信息”, “success”: false }


## 业务异常码

| 名称 | 描述 |
| ------------ | ------------- |
| PERMISSION_DENIED | 设备没有经过涂鸦授权,无法在云端注册 |
| NOT_EXISTS| 激活的productKey不存在 |
400-881-8611