Appearance
访客机设备添加
ts
POST https://saas.bisen-iot.com/api/device/visit/device/save
设备添加
- 发送设备序列号，设备名称，设备备注和应用id至百胜物联云开放平台云端服务器（后述简称云端），设备录入到云端，也可理解为将设备添加到云端服务器中
- 设备与URL中写入的appId绑定，设备-appId的对应关系会存在云端服务器中，一台设备同时只能绑定一个应用
- tag字段，提供第三方用户扩展使用，支持自定义标注设备属性或根据业务场景需求进行标注
使用场景
- 全新的设备需要启用，需在一个应用下进行添加
- 已使用设备，调用设备删除接口断开设备与云端的关联后，与其他应用进行绑定
备注
- 设备名称若为空则默认为设备序列号
- 设备序列号和应用id不能为空
- 若应用为下线状态则不可执行此操作
请求数据
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": "123456789",// 设备序列号
"deviceName": "测试",// 设备名称
"modelName": "访客机设备2020-v1", //型号名称
"tag": "这是一个测试设备",// 设备备注,开发者自定义传入
"status": 2,// 设备状态 1：正常 2：禁用
"onlineStatus": 1,// 设备在线状态, 1:在线 2：离线
"version": "6.0011",// 设备应用版本号
"createTime": "2018-01-01 00:00:00" // 设备创建时间
}
}