Appearance
健康码设备添加
ts
POST https://saas.bisen-iot.com/api/device/generalSmart/save
健康码设备添加
- 发送设备序列号至百胜物联云开放平台云端服务器（后述简称云端），设备录入到云端，也可理解为将设备添加到云端服务器中
- 设备与URL中写入的appId绑定，设备-appId的对应关系会存在云端服务器中，一台设备同时只能绑定一个应用
- verificationMode字段，为验证方式 1：验证身份后开门 2：不验证身份开门
- tag字段，提供第三方用户扩展使用，支持自定义标注设备属性或根据业务场景需求进行标注
使用场景
- 全新的设备需要启用，需在一个应用下进行添加
- 已使用设备，调用设备删除接口断开设备与云端的关联后，与其他应用进行绑定
备注
- 添加设备之前要确保云端设备仓库中存在此设备序列号
- 省份、城市参数为空默认为江西、南昌；
- 行政区，验证方式，组织类型，经纬度（经度，纬度）等参数不能为空；
- 若应用为下线状态则不可执行此操作
请求数据
header域
| 名称 | 类型 | 可空 | 默认 | 描述 |
|---|---|---|---|---|
| Authorization | String | N | 调用鉴权接口获取（拼接前缀:Bearer+空格) | |
| Content-Type | String | N | application/json | 指定请求的媒体类型 |
Query域
| 名称 | 类型 | 可空 | 默认 | 描述 |
|---|---|---|---|---|
| appId | String | N | 应用Id |
Body域
| 名称 | 类型 | 可空 | 默认 | 描述 |
|---|---|---|---|---|
| deviceNo | String | N | 设备序列号 | |
| deviceName | String | N | 设备名称 | |
| tag | String | Y | 备注 | |
| provinceCode | String | Y | 360000 | 省份code |
| provinceName | String | Y | 江西省 | 省份名称 |
| cityCode | String | Y | 360100 | 城市code |
| cityName | String | Y | 南昌市 | 城市名称 |
| districtCode | String | N | 行政区code | |
| districtName | String | N | 行政区名称 | |
| detailAddress | String | Y | 详细地址 | |
| verificationMode | int | N | 验证方式 1：验证身份后开门 2：不验证身份开门 | |
| tissueType | int | N | 组织类型 1：小区 2:单位 | |
| unitCode | String | Y | 单位码code（组织类型为单位时，单位码必填） | |
| coordinates | String | N | 经纬度（经度，纬度） |
返回数据
200 返回样式
ts
{
"code": 0,
"msg": "success",
"data": {
"appId": "9E5E6BC2C76F4924B9FE40C8966F5D72",// 设备所属应用Id
"deviceNo": "7C4A3B3378B4F***",// 设备序列号
"tag": "这是一个测试设备",// 设备备注,开发者自定义传入
"deviceName": "测试",// 设备名称
"provinceCode": "360000", // 省份code
"provinceName": "江西省", // 省份名称
"cityCode": "360100", // 城市code
"cityName": "南昌市", // 城市名称
"districtCode": "200000", // 行政区code
"districtName": "小蓝区", // 行政区名称
"detailAddress": "某某街道某某小区120号", // 详细地址
"onlineStatus": 1, // 网络状态
"verificationMode" 1, // 验证方式 1：验证身份后开门 2：不验证身份开门
"unitCode" : "9078985d44ca4ad1ae4af45626aadb89", // 单位码
"tissueType" : 1, // 组织类型 1：小区 2:单位
"createTime": "2018-01-01 00:00:00" // 创建时间
}
}