Appearance
车位锁设备添加
ts
POST http://www.bisen-iot.com/api/device/parking/create
车位锁设备添加
- 发送设备序列号至百胜物联云开放平台云端服务器(后述简称云端),设备录入到云端,也可理解为将设备添加到云端服务器中
- 设备与URL中写入的appId绑定,设备-appId的对应关系会存在云端服务器中,一台设备同时只能绑定一个应用
- tag字段,提供第三方用户扩展使用,支持自定义标注设备属性或根据业务场景需求进行标注
使用场景
- 全新的设备需要启用,需在一个应用下进行添加
备注
- 若应用为下线状态则不可执行此操作
请求数据
header域
| 名称 | 类型 | 可空 | 默认 | 描述 |
|---|---|---|---|---|
| Authorization | String | N | 调用鉴权接口获取(拼接前缀:Bearer+空格) | |
| Content-Type | String | N | application/json | 指定请求的媒体类型 |
Body域
| 名称 | 类型 | 可空 | 默认 | 描述 |
|---|---|---|---|---|
| appId | String | N | 应用Id | |
| deviceNo | String | N | 设备序列号 | |
| controlNo | String | Y | 若为空则默认为设备序列号 | 控制器号 |
| deviceName | String | N | 设备名称 | |
| tag | String | Y | 备注 | |
| provinceCode | String | Y | 360000 | 省份 |
| cityCode | String | Y | 360100 | 城市 |
| districtCode | String | N | 行政区code | |
| detailAddress | String | Y | 详细地址 | |
| coordinates | String | N | 经纬度(经度,纬度) |
返回数据
200 返回样式
ts
{
"code": 0,
"msg": "success",
"data": {
"deviceNo": "84E0F4208838000A",// 设备序列号
"controlNo": "84E0F4208838000A",// 控制器号
"tag": "这是一个测试设备",// 设备备注,开发者自定义传入
"deviceName": "测试设备",// 设备名称
"modelName": "BS_PARKING_V1.0", // 设备型号
"productPictureUrl": "http://www.xxxxxx.jpg", // 产品图片
"typeCode": "PARKING_LOCK_DEVICE", // 设备类型
"typeName": "停车设备类", // 设备类型名称
"status": 1, // 设备状态(1:正常 2:故障)
"onlineStatus": 1,// 设备在线状态, 1:在线 2:离线
"statusRemark": "123456", // 设备状态码
"runStatus": 1, //运行状态 0 关门 1 开门 2 停止
"version": "parking_v1.0", // 版本信息
"deviceAddress":{
cityCode: "110100", //城市code
cityName: "北京城区", //城市名称
coordinates: "115.87140286,28.56049762", // 坐标(经纬度)
detailAddress: "1", // 详细地址
districtCode: "110101", // 区域code
districtName: "东城区", // 区域名称
provinceCode: "110000", // 省份code
provinceName: "北京市" // 省份名称
},
"abilityGroup": {
"ability",
"xxxxxxx"
},
"createTime": "2021-01-01 00:00:00" // 创建时间
}
}