Skip to content
导航目录

智能门体设备添加

ts
	POST http://www.bisen-iot.com/api/device/entrance/guard/create

智能门体设备添加

  • 发送设备序列号至百胜物联云开放平台云端服务器(后述简称云端),设备录入到云端,也可理解为将设备添加到云端服务器中
  • 设备与URL中写入的appId绑定,设备-appId的对应关系会存在云端服务器中,一台设备同时只能绑定一个应用
  • tag字段,提供第三方用户扩展使用,支持自定义标注设备属性或根据业务场景需求进行标注

使用场景

  • 全新的设备需要启用,需在一个应用下进行添加

备注

  • 若应用为下线状态则不可执行此操作

请求数据

header域
名称类型可空默认描述
AuthorizationStringN调用鉴权接口获取(拼接前缀:Bearer+空格)
Content-TypeStringNapplication/json指定请求的媒体类型
Body域
名称类型可空默认描述
appIdStringN应用Id
deviceNoStringN设备序列号
deviceNameStringN设备名称
tagStringY备注
provinceCodeStringY360000省份
cityCodeStringY360100城市
districtCodeStringN行政区code
detailAddressStringY详细地址
coordinatesStringN经纬度(经度,纬度)

返回数据

200 返回样式
ts
	{
		"code": 0,
		"msg": "success",
		"data": {
			"appId": "9E5E6BC2C76F4924B9FE40C8966Fxxxx",// 设备所属应用Id
			"deviceNo": "84E0F4208838000A",// 设备序列号
			"tag": "这是一个测试设备",// 设备备注,开发者自定义传入
			"deviceName": "测试设备",// 设备名称
			"modelName": "BS_BRAKE_V1.0", // 设备型号
			"productPictureUrl": "http://www.xxxxxx.jpg", // 产品图片
			"deviceType": "brake_device",  // 设备类型
			"deviceTypeName": "道闸类",  // 设备类型名称
			"status": 1, // 设备状态(1:正常 2:故障)
			"onlineStatus": 1,// 设备在线状态, 1:在线 2:离线
			"statusRemark": "123456",  // 设备状态码
			"runStatus": 1,  //运行状态 0 关门 1 开门 2 停止
			"version": "brake_1.0",  // 版本信息
			"deviceNumber": 1,  // 设备数量
			"deviceBattery":{
				cityCode: "110100",  //城市code
				cityName: "北京城区",  //城市名称
				coordinates: "115.87140286,28.56049762",  // 坐标(经纬度)
				detailAddress: "1", // 详细地址
				districtCode: "110101",  // 区域code
				districtName: "东城区",  // 区域名称
				provinceCode: "110000",  // 省份code
				provinceName: "北京市"  // 省份名称
			},
			"DeviceBatteryOutput":{
				"batteryStatus": 1, // 电池状态
				"batteryEnergy": "100%" // 电池电量
			},
			"createTime": "2021-01-01 00:00:00" // 创建时间
		}
	}

根据 MIT 许可证发布