新增设备
请求方式：POST
URL: http(s)://api.heclouds.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码”}，imei、imsi规则见说明 |
| 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.heclouds.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中imei（15位数字）和imsi（不超过15位数字，不为空）均由数字组成。