跳到主要内容

创建设备

接口简述​

通过 Neptune API 创建一个设备

请求地址​

/device/create

请求方式​

POST

请求参数​

序号名称必填描述
1app_id是开发者账号
2app_secret是开发者密码
3name是设备名称
4uuid否设备序列号(选填,不传则系统自动生成)
5group否设备所属组名
6template否设备应用的 template 名称
7remarks否设备描述信息

请求示例​

// 使用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

序号名称描述
1code请求状态:
200 = 请求成功;
401 = Token授权失败;
1005 = 设备可接入数量已达到上限 ;
1006 = UID不符合规则:UUID长度在6~40位, 只能包含[数字][字符][-][_];
1007 = UUID已存在;
2message请求状态描述
3data请求成功时,返回创建设备的信息;失败时为空

返回值示例​

{
"code": 200,
"message": "",
"data": {
"uuid": "0ADF-EF22-838F-122E",
"group": "污水处理",
"baseInfo": {
"name": "测试机器人",
"remarks": "这是机器人"
}
}
}