新增设备
请求方式:POST
URL: http://api.heclouds.com/devices
http body参数
参数名称 |
格式 |
是否必须 |
说明 |
title |
string |
是 |
设备名称 |
desc |
string |
否 |
设备描述 |
tags |
array-string |
否 |
设备标签,可为一个或者多个,见示例 |
location |
json |
否 |
设备位置坐标信息,以经纬度键值对表示:{"lon":xx,"lat":xx} |
private |
bool |
否 |
设备私密性,决定应用编辑器分享链接中设备信息的可见度,默认为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"
}