新增設備
請求方式:POST
URL: http://api.onenet.hk.chinamobile.com/devices
http body參數
參數名稱 |
格式 |
是否必須 |
說明 |
title |
string |
是 |
設備名稱 |
desc |
string |
否 |
設備描述 |
tags |
array- string |
否 |
設備標籤,可為一個或者多個,見示例 |
location |
json |
否 |
設備位置座標信息,以經緯度鍵值對表示:{“lon”:xx,“lat”:xx} |
private |
bool |
No |
設備私密性,決定應用編輯器分享連結中設備信息的可見度,預設為true |
auth_info |
string |
否 |
鑒權信息,建議攜帶,並設置為設備的產品序號 |
other |
json |
否 |
其他設備自訂信息,以鍵值對格式表示,見示例 |
返回參數
參數名稱 |
格式 |
說明 |
errno |
int |
調用錯誤碼,為0表示調用成功 |
error |
string |
錯誤描述,為“succ”表示調用成功 |
data |
json |
介面調用成功之後返回的設備相關信息,見data描述表 |
data描述表
參數名稱 |
格式 |
說明 |
device_id |
string |
設備ID |
請求body示例
{
"title": "test_device",
"desc": "test_desc",
"tags": ["china", "mobile"],
"location": {
"lon": 109,
"lat": 23.54
},
"auth_info": "tes01235n82105",
"other": {
"version": "1.0.0",
"manufacturer": "china mobile"
}
}
返回示例
{
"errno": 0,
"data": {
"device_id": "35270468"
},
"error": "succ"
}