创建设备
请求方式:POST
URL: http://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=
Content-Type: application/json
Host: api.heclouds.com
http请求参数示例
{
"title": "mydevice",
"desc": "some description",
"tags": ["china", "mobile"],
"protocol": "LWM2M",
"location": {"lon": 106, "lat": 29, "ele": 370},
"private": true,
"auth_info": {"xxxxxxxxxxxx": "xxxxxxxxxxx"},
"auth":"1233311",
"obsv": true,
"other": {"version": "1.0.0", "manu": "china mobile"},
"chip":1,
"psk":"dafdfdsafd"
}
返回示例
{
"errno": 0,
"data": {
"device_id": "23444",
"psk":"23ddafd3444"
},
"error": "succ"
}