註冊設備
為用戶提供設備註冊的方法,當設備名稱已存在時,介面返回當前設備信息
請求語法
POST /mqtt/v1/devices/reg
Authorization:xxxx
Content-Type:application/json
{
"name":"IMEI12345678901",
"desc":"some description",
"key":"5h2QzmpEqD7IqaOYNoj2kuNNm1Q="
}
body說明
參數名稱 |
類型 |
是否必填 |
說明 |
name |
string |
Yes |
設備名稱,產品下唯一標識,建議使用設備SN、IMEI、MAC作為設備名稱,僅支援英文、數位、"_"、"- ",長度1-64 |
desc |
string |
No |
設備描述,長度0-100 |
key |
string |
No |
必須為base64編碼格式,原始碼長度不得超過32位元組 缺省情況下,平台自動分配設備key |
返回語法
{
"request_id":"855b2fe4-3f54-41f2-8cd5-3e34bcfa8356",
"code_no":"000000",
"code":"onenet_common_success",
"message":null,
"data":{
"device_id":"12345",
"name":"IMEI12345678901",
"pid":1234,
"key":"5h2QzmpEqD7IqaOYNoj2kuNNm1Q="
}
}
data參數說明
參數名稱 |
類型 |
說明 |
device_id |
string |
設備ID |
name |
string |
設備名稱 |
pid |
int |
產品ID |
key |
string |
設備金鑰 |
更多幫助
查看api返回錯誤碼