Appearance
监控设备添加
ts
POST https://saas.bisen-iot.com/api/device/ipc/create
设备添加
- 发送设备序列号,设备名称,设备备注和应用id至百胜物联云开放平台云端服务器(后述简称云端),设备录入到云端,也可理解为将设备添加到云端服务器中
- 设备与URL中写入的appId绑定,设备-appId的对应关系会存在云端服务器中,一台设备同时只能绑定一个应用
- tag字段,提供第三方用户扩展使用,支持自定义标注设备属性或根据业务场景需求进行标注
使用场景
- 全新的设备需要启用,需在一个应用下进行添加
备注
- 设备名称为空则默认为设备序列号
- 若应用为下线状态则不可执行此操作
请求数据
header域
| 名称 | 类型 | 可空 | 默认 | 描述 |
|---|---|---|---|---|
| Authorization | String | N | 调用鉴权接口获取(拼接前缀:Bearer+空格) | |
| Content-Type | String | N | application/json | 指定请求的媒体类型 |
Body域
| 名称 | 类型 | 可空 | 默认 | 描述 |
|---|---|---|---|---|
| appId | String | N | 应用Id | |
| deviceNo | String | N | 设备序列号 | |
| deviceName | String | Y | 设备序列号 | 设备名称 |
| tag | String | Y | 备注 |
返回数据
200 返回样式
ts
{
"code": 0,
"msg": "success",
"data": {
"deviceNo": "1000114", // 设备序列号
"deviceName": "监控设备名称",// 设备名称
"modelName": "BS_IPC_1.0", //型号名称
"tag": "这是一个测试设备", // 设备备注,开发者自定义传入
"status": 2,// 设备状态 1:正常 2:禁用
"onlineStatus": 1,// 设备在线状态, 1:在线 2:离线
"version": "V2.622.0000000.9.R",// 设备版本号
"channelNums": 8, // 通道数量
"createTime": "2020-01-01 00:00:00" // 设备创建时间
}
}