创建设备
接口简述
通过 Neptune API 创建一个设备
请求地址
/device/create
请求方式
POST
请求参数
序号 | 名称 | 必填 | 描述 |
---|---|---|---|
1 | app_id | 是 | 开发者账号 |
2 | app_secret | 是 | 开发者密码 |
3 | name | 是 | 设备名称 |
4 | uuid | 否 | 设备序列号(选填,不传则系统自动生成) |
5 | group | 否 | 设备所属组名 |
6 | template | 否 | 设备应用的 template 名称 |
7 | remarks | 否 | 设备描述信息 |
请求示例
// 使用jQuery AJax作为请求提交工具
$.ajax({
type: "post",
url: "https://api.neptune-iiot.net/device/create",
dataType: "json",
data: {
app_id: "nep863f8291",
app_secret: "720f8d0d3cf3b38ff190892a7840ad68",
name: "测试机器人",
uuid: "0ADF-EF22-838F-122E",
group: "污水处理",
template: "污水处理模板",
remarks: "这是机器人"
}
});
返回值说明
返回值格式为JSON
序号 | 名称 | 描述 |
---|---|---|
1 | code | 请求状态: 200 = 请求成功; 401 = Token授权失败; 1005 = 设备可接入数量已达到上限 ; 1006 = UID不符合规则:UUID长度在6~40位, 只能包含[数字][字符][-][_]; 1007 = UUID已存在; |
2 | message | 请求状态描述 |
3 | data | 请求成功时,返回创建设备的信息;失败时为空 |
返回值示例
{
"code": 200,
"message": "",
"data": {
"uuid": "0ADF-EF22-838F-122E",
"group": "污水处理",
"baseInfo": {
"name": "测试机器人",
"remarks": "这是机器人"
}
}
}