重庆市智慧工地数据中心接口之施工升降机接口v3.0

作者：程象添加时间：2022-10-11

对接重庆住建局智慧工地平台：重庆实名制人脸识别设备，重庆实名制通道，重庆工地扬尘环境监测设备等智慧工地系统对接重庆住建局监管平台。联系程象科技：陈工18923455298

智慧工地数据中心接口之

施工升降机接口v3.0

版本	时间	变更内容
V3.0	2019-07-19	3.0版本

1. 接口说明

工地现场的施工升降机的工作数据，包括：工作开始时间，结束时间，运载人数，起始高度，结束高度，运行速度，载重，最大载重百分比，运行方向等数据通过该接口上传至智慧工地数据中心。本接口可接收硬件设备直传，也能够接收硬件供应商的服务器转发。但要求硬件供应商在接收到工地现场硬件数据后同步转发。

上传数据前供应商需要取得智慧工地信息管理平台的授权，否则将无法通过接口上传数据。

2. 通讯方式

数据接口采用HTTP协议，数据格式采用JSON。

3. 接口数据格式

3.1. 接口地址

/api/open/iot/v3/lifter/record

3.2. 请求方法

POST

3.3. 请求内容

1. 请求头

请求头具体的生成方法请参考《智慧工地数据中心接口之认证鉴权接口》。

2. 请求体

请求体为JSON数据格式，内容为JSON对象数据，表示可以一次传入多行记录。但提醒开发者请不要一次性写入过多数据，建议每次最多不超过50行数据。

[

{

"sourceId":"9b2db993-857f-11e7-857d-00163e32d704",

"registNo" : "渝ZZ-S00125”,

"serialNo":" TSVS837819828",

"recordTime“:"2017-08-11 13:20:25",

"startTime":"2017-08-11 13:19:05",

"stopTime":"2017-08-11 13:19:45",

"startHeight":12,

"stopHeight":15,

"speed":2.1,

"load":13,

"loadPercent":80,

"direction":1,

" driverId ":"",

" driverLicence ":"",

" driverName ":"",

"status":"0",

"message":””

}

]

各字段说明如下表：

字段名称	值类型	说明	是否必输
sourceId	String	来源数据id，外部系统跟踪数据用	否
serialNo	String	设备物理编号	是
recordTime	String(yyyy-MM-dd HH:mm:ss)	采集时间	是
startTime	String(yyyy-MM-dd HH:mm:ss)	开始工作时间	是
stopTime	String(yyyy-MM-dd HH:mm:ss)	停止工作时间	是
startHeight	Double	开始运行高度	是
stopHeight	Double	停止运行高度	是
speed	Double	运行速度	是
load	Double	本次运行载重	是
loadPercent	Double	本次运行最大载重百分比	是
direction	int	运行方向，1:上升,2:下降	是
driverId	String	驾驶员身份证号	是
driverLicence	String	驾驶员证书编号	是
driverName	String	驾驶员姓名	是
status	String	状态, 0：正常 1：预警 2：报警 3：违章 4：其他	是
message	String	预警/报警/违章消息，非正常状态时必须传入	当不为0时，非空。

3.4. 返回值

{

"code":"1",

"message":"请求数据格式错误",

content: {

...

}

返回值说明：

字段名	说明
code	错误代码，内容见3.5
message	错误描述
content	错误细节，部分保存失败时会返回保存失败的数据的sourceId列表

3.5. 错误代码

代码值	说明
0	正常
1	参数格式
2	数据内容错误
3	无授权
4	系统异常

4. 上传心跳

心跳固定每10秒上传一次，平台校验与上次收到心跳的时间差，如果小于10s,则视为此次数据无效，如果大于等于10s则将设备在线时间加10s并更新最新心跳时间为此次收到心跳的时间。

4.1. 接口地址

/api/open/iot/v3/lifter/heartbeat

4.2. 请求方法