设备注册

一个新型号的设备要接入中台，必须先在中台创建产品型号，中台会自动生成设备的productKey和secretKey ，设备将此信息写入固件，用于自动注册。

设备启动后，通过调用注册接口，此时中台会将设备对应的clientId、 username和password写入MQTT服务器的认证数据库中，接下来设备才可以连接MQTT服务器，从而接入中台。

设备需要使用注册接口返回的clientId、 username和password连接MQTT服务器，然后与中台开始通讯。

自动注册接口包括2个：

GET

URI: /exchange/device/register
Method: GET

1 - 表示成功；0 - 表示失败。

参数	类型	说明
data	Object	响应信息中包含： `clientId` - 设备连接MQTT服务器的客户端ID`username` - 设备连接MQTT服务器的用户名`password` - 设备连接MQTT服务器的密码`productKey` - 产品信息中的ProductKey`secretKey` - 产品信息中的SecretKey`sn` - 设备的SN

URI: /exchange/device/register
Method: POST
Content-Type: application/json

参数	类型	说明
请求体	Object	Request Payload请求体，其中必填项包括： `productKey` - 产品信息中的ProductKey`secretKey` - 产品信息中的SecretKey`sn` - 设备的SN

1 - 表示成功；0 - 表示失败。

参数	类型	说明
data	Object	响应信息中包含： `clientId` - 设备连接MQTT服务器的客户端ID `username` - 设备连接MQTT服务器的用户名 `password` - 设备连接MQTT服务器的密码 `productKey` - 产品信息中的ProductKey `secretKey` - 产品信息中的SecretKey `sn` - 设备的SN

注册失败时，中台回复如下消息：

{
    "success": "0",
    // 错误编码
    "errorCode": "1016",
    // 错误消息
    "errorMsg": "Error Message"  
}

编码	说明
1016	secretKey或SN参数缺失
2100	productKey参数缺失或错误，或中台数据库比较旧，没有该型号数据
2112	secretKey错误
1099	未知错误，请联系平台运维人员

16 三月 2026