新增設備
請求方式：POST
URL: http(s)://api.onenet.hk.chinamobile.com/devices
http body 請求參數
| 參數名称 | 格式 | 是否必須 | 說明 |
|---|---|---|---|
| title | string | 是 | 設備名稱 |
| desc | string | 否 | 設備描述 |
| tags | array-string | 否 | 設備標籤，字串陣列 |
| protocol | string | 是 | 接入協議，這裡只能是LwM2M |
| location | json | 否 | 設備位置（“緯度”，“經度”，“高度”） |
| private | bool | 否 | 設備私密性（預設true） |
| auth_info | json | 是 | NBIOT設備：{“imei碼”：“imsi碼”}，me 、ms 規則見說明 |
| auth | string | 否 | Auth_Code，由數位或字母組成，不超過16位 |
| obsv | bool | 否 | 是否訂閱設備資源（預設為true） |
| other | json | 否 | 其他信息（JSON格式，可自訂） |
| chip | int | 否 | 測試設備與晶片類型對應關係（取值1-6），詳情見說明 |
| psk | string | 否 | DTLS加密所使用的PSK，長度8-16個位元組，字母或數位組成 |
返回參數
| 參數名稱 | 格式 | 說明 |
|---|---|---|
| errno | int | 調用錯誤碼，為0表示調用成功 |
| error | string | 錯誤描述，為"succ"表示調用成功 |
| data | json | 介面調用成功之後返回的設備相關信息，見data描述表 |
data描述表
| 參數名稱 | 格式 | 說明 |
|---|---|---|
| device_id | string | 平台分配唯一ID |
| psk | string | 在NB協議開啟DTLS加密功能時返回該欄位，其他情況沒有該欄位 |
說明
| 分類 | IMEI | IMSI | chip | 備注 |
|---|---|---|---|---|
| 正式設備 | 15位元數字 | 不超過15位元數字，不為空 | 無 | 正式設備無需chip值 |
| 測試設備 | 4位元數字 | 不超過15位元數字，不為空 | 取值1-6 | 測試設備必須填寫chip值 |
chip值對應表
| chip取值 | 1 | 2 | 3 | 4 | 5 | 6 |
|---|---|---|---|---|---|---|
| 晶片名稱 | MTK | 華為120 | 華為150 | 高通 | 中興微 | RDA |
請求示例
POST http://api.onenet.hk.chinamobile.com/devices HTTP/1.1
api-key: WhI*************v1c= //必須為 MasterKey,由於涉及個人隱私,這裡用“*******” 代替
Content-Type: application/json
http請求參數示例
{
"title": "mydevice", //設備名稱
"desc": "some description", //設備描述（可選）
"tags": ["china", "mobile"], //設備標籤（可選， 可為一個或多個）
"protocol": "LwM2M", //接入協議
"location": {"lon": 106, "lat": 29, "ele": 370}, //設備位置{"緯度", "精度", "高度"}（可選）
"private": true, //設備私密性（可選， 默認為 ture）
"auth_info": {"xxxxxxxxxxxx": "xxxxxxxxxxx"}, //NBIOT設備:{"imei" ："imsi"},imei（必須為15位）和imsi（不超過15位）都由數字組成，且首位不能為0
"auth":"1233311",
"obsv": true, //是否訂閱設備資源,默認為true
"other": {"version": "1.0.0", "manu": "china mobile"}, //其他信息（可選，JSON格式，可自定義）
"chip":1, //參考chip值對應表
"psk":"dafdfdsafd"
}
返回示例
{
"errno": 0, //無錯誤
"data": {
"device_id": "23444", //平台分配唯一ID
"psk":"23ddafd3444"
},
"error": "succ"
}
⋙⋙⋙⋙⋙
說明：
(1) 回應訊息中errno表示錯誤碼，error表示錯誤原因，如果創建設備失敗，則沒有device_id欄位；
(2) NB CoAP設備auth_info中me （15位元數字）和ms （不超過15位元數位，不為空）均由數位組成。