智慧工地平台接口文档

设备厂商--->平台系统接口

扬尘对接

1、添加扬尘噪声实时数据信息

接口描述：	添加扬尘噪声实时数据信息
请求URL:	/xmgl/dustNoiseData/add
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	说明	参数类型	是否必须	类型
deviceId	设备Id	body	true	string
humidity	湿度	body	false	float
humidityAlarmType	湿度是否报警，0否，1是	body	false	int32
noise	噪音	body	false	float
noiseAlarmType	噪音是否报警，0否，1是	body	false	int32
plateHumidity	板载湿度	body	false	float
plateTemperature	板载温度	body	false	float
pm10	扬尘	body	false	float
pm10AlarmType	pm10是否报警，0否，1是	body	false	int32
pm25	pm25	body	false	float
pm25AlarmType	PM25是否报警，0否，1是	body	false	int32
pressure	大气压	body	false	float
temperature	温度	body	false	float
temperatureAlarmType	温度是否报警，0否，1是	body	false	int32
tsp	tsp测试值	body	false	float
tspAlarmType	tsp是否报警，0否，1是	body	false	int32
voltage	电压	body	false	float
windSpeedAlarmType	风速是否报警，0否，1是	body	false	int32
winddirection	风向	body	false	string
winddirectionName	风向名称	body	false	string
windspeed	风速	body	false	float

请求示例：


{
  "crc": "",
  "deviceId": "",
  "humidity": 0,
  "humidityAlarmType": 0,
  "noise": 0,
  "noiseAlarmType": 0,
  "plateHumidity": 0,
  "plateTemperature": 0,
  "pm10": 0,
  "pm10AlarmType": 0,
  "pm25": 0,
  "pm25AlarmType": 0,
  "pressure": 0,
  "temperature": 0,
  "temperatureAlarmType": 0,
  "tsp": 0,
  "tspAlarmType": 0,
  "voltage": 0,
  "windSpeedAlarmType": 0,
  "winddirection": "",
  "winddirectionName": "",
  "windspeed": 0
}

响应示例：

失败：


xxxxxxxxxx
{
  "success": false,
  "message": "设备编号不正确",
  "code": 5000,
  "result": null,
  "timestamp": "1677809107994"
}

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1677809789150"
}

2、修改绿色扬尘设备喷淋状态

接口描述：	修改绿色扬尘设备喷淋状态
请求URL:	/xmgl/environmentDev/updateEnvironmentDevSprayStatus
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	说明	参数类型	是否必须	类型
deviceId	设备Id	body	true	string
sprayStatus	喷淋状态（1投运2未投运）	body	true	int

请求示例：


xxxxxxxxxx
{
  "deviceId": "001",
  "sprayStatus": 1
}

响应示例：

失败：


xxxxxxxxxx
{
  "success": false,
  "message": "设备编号不正确",
  "code": 5000,
  "result": null,
  "timestamp": "1677809107994"
}

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1677809789150"
}

塔吊在线监测系统对接

1、添加塔吊实时数据

接口描述：	添加塔吊实时数据
请求URL:	/xmgl/towerCurrentData/add
请求方式:	POST
Content-Type：	application/json

请求参数：

字段	类型	说明	是否必传
devSn	String	设备识别码(平台生成的唯一识别码)	是
reciveTime	String	上传时间，时间格式如2021-03-08 09:23:08	是
startTime	String	运行开始时间，时间格式如2021-03-08 09:23:08	否
loading	float	载重 (kg),保留两位小数	是
loadRatio	float	载重比,保留两位小数	否
torque	float	力矩,保留两位小数	是
torqueRatio	float	力矩比,保留两位小数	否
angle	float	角度(° ),保留两位小数	是
ranger	float	幅度,单位米 ,保留两位小数	是
height	float	吊钩运行高度,单位米,保留两位小数	是
windspeed	float	风速(m/s),保留两位小数	是
obliguity	float	倾角	是
rate	float	倍率,保留两位小数	是
driverName	String	司机姓名	否
driverIdCard	String	司机身份证号	否
obliguityX	float	倾角X	是
obliguityY	float	倾角Y	是
noError	char	无任何外设故障 0:有外设故障 1无任何外设故障	是
weightError	char	载重传感器故障 0:无故障 1:有故障	否
windSpeedError	char	风速传感器故障 0:无故障 1:有故障	否
rangeError	char	幅度传感器故障 0:无故障 1:有故障	否
heightError	char	高度传感器故障 0:无故障 1:有故障	否
angleError	char	角度传感器故障 0:无故障 1:有故障	否
obliguityError	char	倾角传感器故障 0:无故障 1:有故障	否
gpsError	char	GPS故障 0:无故障 1:有故障	否
idError	char	身份识别模块故障 0:无故障 1:有故障	否
noAlarm	char	无任何报警 0:有报警 1无任何报警	是
momentAlarm	char	力矩报警 0:正常 1:报警2:预警	否
windSpeedAlarm	char	风速报警 0:正常 1:报警2:预警	否
heightAlarm	char	高度上限位报警 0:正常 1:报警2:预警	否
heightLowerAlarm	char	高度下限位报警 0:正常 1:报警2:预警	否
minRangeAlarm	char	幅度内限位报警 0:正常 1:报警2:预警	否
maxRangeAlarm	char	幅度外限位报警 0:正常 1:报警2:预警	否
posAngleAlarm	char	顺时针回转限位报警 0:正常 1:报警2:预警	否
negAngleAlarm	char	逆时针回转限位报警 0:正常 1:报警2:预警	否
obliguityAlarm	char	倾角报警 0:正常 1:报警2:预警	否
forbidEntryAlarm	char	禁入区报警 0:正常 1:报警	否
forbidSuspend2Alarm	char	A类禁吊区域报警 0:正常 1~5:1~5区域报警	否
forbidSuspend4Alarm	char	B类禁吊区域报警 0:正常 1~5:1~5区域报警	否
multiAlarmAll	char	多机防撞报警 0:正常 1:报警	否
forbidEntryPosAlarm	char	禁入区右转报警 0:正常 1:报警	否
forbidEntryNegAlarm	char	禁入区左转报警 0:正常 1:报警	否
forbidSuspend2PosAlarm	char	A类禁吊区右转报警 0:正常 1:报警	否
forbidSuspend2NegAlarm	char	A类禁吊区左转报警 0:正常 1:报警	否
forbidSuspend2OutAlarm	char	A类禁吊区向外变幅报警 0:正常 1:报警	否
forbidSuspend4PosAlarm	char	B类禁吊区右转报警 0:正常 1:报警	否
forbidSuspend4NegAlarm	char	B类禁吊区左转报警 0:正常 1:报警	否
forbidSuspend4OutAlarm	char	B类禁吊区向外变幅报警 0:正常 1:报警	否
forbidSuspend4BackAlarm	char	B类禁吊区向内变幅报警 0:正常 1:报警	否
multiPosAlarm	char	多机防撞右转报警 0:正常 1:报警	否
multiNegAlarm	char	多机防撞左转报警 0:正常 1:报警	否
multiOutAlarm	char	小车多机防撞向外变幅（幅度增加）报警 0:正常 1:报警	否
multiBackAlarm	char	小车多机防撞向内变幅（幅度减少）报警 0:正常 1:报警	否
obliguityXAlarm	char	倾角X报警 0:正常 1:报警 2:预警	否
obliguityYAlarm	char	倾角Y报警 0:正常 1:报警 2:预警	否
heightDirection	char	起升状态 0:停止升降 1:向下落勾 2:向上起勾	否
rangeDirection	char	变幅状态 0:停止变幅 1:向外变幅 2:向内变幅	否
angleDirection	char	回转状态 0:停止回转 1:向右回转 2:向左回转	否
collisionList	Array	多机防碰撞设备与本设备碰撞的列表	否

collisionList 说明

字段	类型	说明	是否必传
collideDevSn	String	碰撞设备识别码(平台生成的唯一识别码)	是
multiNo	int	本机的多机防撞组网序号	否

备注：有防碰撞报警时候，本机器与其它设备防碰撞，collisionList字段必填，collideDevSn为被碰撞设备唯一标识，multiNo是多机防撞组网序号，默认collideDevSn必传，collideDevSn和multiNo两个字段至少传一个。多个设备防碰撞就有多条记录。

图1 设置禁入区图2 设置A类禁吊区域

图3 设置B类禁吊区域

请求示例：


xxxxxxxxxx
{
    "devSn": "23020621",
    "reciveTime": "2021-03-08 09:23:08",
    "loading": 1.00,
    "torque": 1.00,
    "angle": 1.00,
    "ranger": 1.00,
    "height": 1.00,
    "windspeed": 1.00,
    "obliguity": 1.00,
    "rate": 1.00,
    "obliguityX": 1.00,
    "obliguityY": 1.00,
    "noError": "1",
    "noAlarm": "1"
}

响应结果：

失败：


xxxxxxxxxx
{
  "success": false,
  "message": "Incorrect equipment number",
  "code": 5000,
  "result": null,
  "timestamp": 1617264186112
}

成功：


xxxxxxxxxx
{
  "success": true,
  "message": "Operation succeeded！",
  "code": 200,
  "result": null,
  "timestamp": 1617264342406
}

2、添加塔吊报警数据

接口描述：	添加塔吊报警数据
请求URL:	/xmgl/towerAlarm/add
请求方式:	POST
Content-Type：	application/json

请求参数：

字段	类型	说明	是否必传
devSn	String	设备识别码(平台生成的唯一识别码)	是
startTime	String	开始时间，时间格式如2021-03-08 09:23:08	是
endTime	String	结束时间，时间格式如2021-03-08 09:23:08	是
driverName	String	司机姓名	否
driverIdCard	String	司机身份证号	否
certification	String	特种作业号	否
alarmType	char	数据报警类型 1:报警 2:预警	是
momentAlarm	char	力矩报警 0: 正常 1:报警 2:预警	是
windSpeedAlarm	char	风速报警 0: 正常 1:报警 2:预警	是
heightAlarm	char	高度上限位报警 0: 正常 1:报警 2:预警	是
heightLowerAlarm	char	高度下限位报警 0:正常 1:报警2:预警	是
minRangeAlarm	char	幅度内限位报警 0: 正常 1:报警 2:预警	是
maxRangeAlarm	char	幅度外限位报警 0: 正常 1:报警 2:预警	是
posAngleAlarm	char	顺时针回转限位报警 0: 正常 1:报警 2:预警	是
negAngleAlarm	char	逆时针回转限位报警 0: 正常 1:报警 2:预警	是
obliguityAlarm	char	倾角报警 0: 正常 1:报警 2:预警	是
environmentAlarm	char	环境防撞报警 0: 正常 1:报警 2:预警	是
multiAlarm	char	多机防撞报警 0: 正常 1:报警 2:预警	是
standardHighAlarm	char	塔机间竖向高度报警 0: 正常 1:报警 2:预警	是
standardHighAlarmDev	String	产生塔机间竖向高度报警的设备识别码例如：当前塔吊和2号塔吊产生此报警。则此处穿2号塔吊的设备识别码。	否

响应结果：

成功：


xxxxxxxxxx
{
  "success": true,
  "message": "操作成功！",
  "code": 200,
  "result": null,
  "timestamp": "1681814472197"
}

3、添加塔吊循环数据

接口描述：	加塔吊循环数据
请求URL:	/xmgl/towerWorkCycle/add
请求方式:	POST
Content-Type：	application/json

请求参数：

字段	类型	说明	是否必传
devSn	String	设备识别码(平台生成的唯一识别码)	是
startTime	String	开始时间，时间格式如2021-03-08 09:23:08	是
endTime	String	结束时间，时间格式如2021-03-08 09:23:08	是
workTime	String	工作时长,单位（s）	是
driverName	String	司机姓名	否
driverIdCard	String	司机身份证号	否
slingStartHeight	String	工作循环开始高度,单位米	是
slingStartRange	String	工作循环开始幅度,单位米	是
slingStartRotation	String	工作循环开始角度(° )	是
slingEndHeight	String	工作循环结束高度,单位米	是
slingEndRange	String	工作循环结束幅度,单位米	是
slingEndRotation	String	工作循环结束角度(° )	是
peakLoad	String	最大负荷载重比(%)	是
loading	String	本次最大载重(kg)	是
workMaxForce	String	工作循环中最大力矩	是
workMaxTorque	String	工作循环最大力矩百分比	否
workMaxTorqueRange	String	工作循环最大力矩时的幅度	否
maxAngle	String	循环最大角度	是
minAngle	String	循环最小角度	是
maxRange	String	循环最大幅度	是
minRange	String	循环最小幅度	是
maxHeight	String	循环最大高度(米)	是
minHeight	String	循环最小高度(米)	是
maxWindSpeed	String	工作循环最大风速	是
workMultiple	int	倍率	否
workMaxRangeAlarm	char	工作循环中是否出现幅度外限位报警 0: 正常 1:报警	否
workMinRangeAlarm	char	工作循环中是否出现幅度内限位报警 0: 正常 1:报警	否
workHeightAlarm	char	工作循环中是否出现高度上限位报警 0: 正常 1:报警	否
workHeightLowerAlarm	char	工作循环中是否出现高度下限位报警 0: 正常 1:报警	否
workPosAngleAlarm	char	工作循环中是否出现顺时针回转限位报警 0: 正常 1:报警	否
workNegAngleAlarm	char	工作循环中是否出现逆时针回转限位报警 0: 正常 1:报警	否
workMomentAlarm	char	工作循环中是否出现力矩报警 0: 正常 1:报警	否
workObliguityAlarm	char	工作循环中是否出现倾角报警 0: 正常 1:报警	否
workEnvironmentAlarm	char	工作循环中是否出现环境防碰撞报警 0: 正常 1:报警	否
workMultiAlarm	char	工作循环中是否出现多机防碰撞报警 0: 正常 1:报警	否
workMomentPreAlarm	char	工作循环中是否出现力矩预警 0: 正常 1:预警	否
workWindSpeedAlarm	char	工作循环中是否有风速报警 0: 正常 1:报警 2:预警	否

响应结果：

成功：


xxxxxxxxxx
{
  "success": true,
  "message": "操作成功！",
  "code": 200,
  "result": null,
  "timestamp": "1681814472197"
}

4、修改塔吊设备信息

接口描述：	修改塔吊设备信息
请求URL:	/xmgl/tower/updateTowerInfo
请求方式:	POST
Content-Type：	application/json

请求参数：

字段	类型	说明	是否必传
devSn	String	设备识别码(平台生成的唯一识别码)	是
posteriorArmLength	double	后臂长，单位米	是
forearmLength	double	前臂长，单位米	是
towerHeight	double	塔身高度，单位米	是
referenceHeight	double	塔顶高度，单位米	是
longtitude	String	经度	否
latitude	String	纬度	否
relatedX	String	相对坐标X	否
relatedY	String	相对坐标Y	否
nodeCount	int	塔节数量	否
multiNo	int	本机的多机防撞组网序号	否
standardHigh	String	塔吊标高	否

响应结果：

成功：


xxxxxxxxxx
{
  "success": true,
  "message": "操作成功！",
  "code": 200,
  "result": null,
  "timestamp": "1681814472197"
}

5、添加塔吊违章数据

接口描述：	添加塔吊违章数据
请求URL:	/xmgl/towerViolation/add
请求方式:	POST
Content-Type：	application/json

请求参数：

字段	类型	说明	是否必传
devSn	String	设备识别码(平台生成的唯一识别码)	是
violationTime	String	违章时间，时间格式如2021-03-08 09:23:08	是
momentViolation	char	力矩违章 0: 正常 1:违章	是
windSpeedViolation	char	风速违章 0: 正常 1:违章	是
collisionViolation	char	群塔碰撞违章 0: 正常 1:违章	是
banRegionViolation	char	禁行区域违章 0: 正常 1:违章	是
personViolation	char	人员报警违章 0: 正常 1:违章	是
hookViolation	char	吊钩违章 0: 正常 1:违章	是

响应结果：

成功：


xxxxxxxxxx
{
  "success": true,
  "message": "操作成功！",
  "code": 200,
  "result": null,
  "timestamp": "1681814472197"
}

6、添加塔吊螺母信息

接口描述：	添加塔吊螺母信息
请求URL:	/xmgl/towerNut/saveNutData
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	说明	参数类型	是否必须	类型
sn	螺母主机ID（塔吊的螺母主机编号）	body	true	string
NutValue	螺母解析数据	body	true	NutValue实体类

NutValue实体类

参数名称	说明	参数类型	是否必须	类型
para	参数（具体看下面第一点）	body	true	int
vt	值类型 0：浮点 1：整形	body	true	int
qds	质量码 0：未初始化值 1：有效值 2：无效值 3：设值值 4：计算值	body	true	int
time	时间	body	true	long
value	数值	body	true	int

1、para参数定义

参数	含义
1	螺母数量
2	离线数量
3	预警数量
101	001#存在
102	001#离线
103	001#预警
104	002#存在
105	002#离线
106	002#预警
107	003#存在
108	003#离线
109	003#预警
110	004#存在
111	004#离线
112	004#预警
113	005#存在
114	005#离线
115	005#预警
116	006#存在
117	006#离线
118	006#预警
119	007#存在
120	007#离线
121	007#预警
122	008#存在
123	008#离线
124	008#预警
125	009#存在
126	009#离线
127	009#预警
128	010#存在
129	010#离线
130	010#预警
...	以此类推

注：001#是指设备编号为1

存在：为 1 时说明此号螺母在设备管理内，为 0 时说明此号螺母不在设备管理内

离线：为 1 时说明此号螺母离线，为 0 时说明此号螺母在线

预警：为 1 时说明此号螺母在预警状态，为 0 时说明此号螺母不在预警状态

请求示例：

保存螺母（每次都要传所有的para）：


xxxxxxxxxx
{
    "sn": "12345",
    "values": [
        {
            "para": 1,
            "vt": 1,
            "qds": 1,
            "time": 0,
            "value": 2
        },
        {
            "para": 2,
            "vt": 1,
            "qds": 1,
            "time": 0,
            "value": 1
        },
        {
            "para": 3,
            "vt": 1,
            "qds": 1,
            "time": 0,
            "value": 1
        },
        {
            "para": 102,
            "vt": 1,
            "qds": 1,
            "time": 0,
            "value": 1
        },
        {
            "para": 106,
            "vt": 1,
            "qds": 1,
            "time": 0,
            "value": 1
        }
    ]
}

响应成功示例：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1690795126284"
}

7、添加塔吊顶升记录

接口描述：	添加塔吊顶升记录
请求URL:	/xmgl/towerJackingRecord/add
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	参数说明	请求类型	是否必须	数据类型
beforeHeght	顶升前高度	body	true	string
createTime	顶升时间（格式：2023-09-13 10:38:37）	body	true	string
devSn	塔吊设备sn	body	true	string
height	顶升后高度	body	true	string
sectionCount	本次顶升的塔吊标准节数量	body	true	string

请求示例：


xxxxxxxxxx
{
    "beforeHeght": "1",
    "createTime": "2023-09-13 10:38:37",
    "devSn": "9506579",
    "height": "1",
    "sectionCount": "2"
}

响应结果：

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1694575442336"
}

升降机在线监测系统对接

1、添加升降机实时数据

接口描述：	添加升降机实时数据
请求URL:	/xmgl/lifterCurrentData/add
请求方式:	POST
Content-Type：	application/json

请求参数：

字段	类型	说明	是否必传
devSn	String	设备识别码(平台生成的唯一识别码)	是
reciveTime	String	上传时间，时间格式如2021-03-08 09:23:08	是
startTime	String	运行开始时间，时间格式如2021-03-08 09:23:08	否
maxLoad	float	准载，单位kg	否
height	float	本次运行高度,单位米	是
loading	float	本次运行载重，单位kg	是
loadRatio	float	本次运行最大载重百分比	否
peopleNumber	Integer	人数	否
speed	float	运行速度，单位m/s	否
floorNum	Integer	当前楼层	否
windSpeed	float	风速，单位m/s	否
dipAngleX	float	倾角X（°）	是
dipAngleY	float	倾角Y（°）	是
frontDoorState	char	前门状态，1关，2开	是
backDoorState	char	后门状态，1关，2开	是
runningState	char	运行状态 1：上升 2：下降	是
isOnline	char	设备是否在线 0、不在线 1、在线	是
driverName	String	司机姓名	否
driverIdCard	String	司机身份证号	否
noError	char	无任何外设故障 0:有外设故障 1: 无任何外设故障	是
idError	char	身份识别模块故障 0:无故障 1: 有故障	否
peopleCntError	char	人数识别装置故障 0:无故障 1: 有故障	否
weightError	char	载重传感器故障 0:无故障 1: 有故障	否
speedError	char	速度传感器故障 0:无故障 1: 有故障	否
heightError	char	高度传感器故障 0:无故障 1: 有故障	否
floorError	char	楼层传感器故障 0:无故障 1: 有故障	否
obliguityXError	char	倾角X传感器故障 0:无故障 1: 有故障	否
obliguityYError	char	倾角Y传感器故障 0:无故障 1: 有故障	否
windSpeedError	char	风速传感器故障 0:无故障 1: 有故障	否
gpsError	char	GPS模块故障 0:无故障 1: 有故障	否
wirelessError	char	楼层呼叫装置故障 0:无故障 1: 有故障	否
noPreAlarm	char	无任何预警 0:有预警 1: 无任何预警	是
weightPreAlarm	char	载重预警 0:正常 1:预警	否
speedPreAlarm	char	速度预警 0:正常 1:预警	否
heightPreAlarm	char	高度预警 0:正常 1:预警	否
obliguityXPreAlarm	char	倾角X预警 0:正常 1:预警	否
obliguityYPreAlarm	char	倾角Y预警 0:正常 1:预警	否
windSpeedPreAlarm	char	风速预警 0:正常 1:预警	否
noAlarm	char	无任何报警 0:有报警 1: 无任何报警	是
peopleCntAlarm	char	人数报警 0:正常 1:报警	否
weightAlarm	char	载重报警 0:正常 1:报警	否
speedAlarm	char	速度报警 0:正常 1:报警	否
heightAlarm	char	高度报警 0:正常 1:报警	否
obliguityXAlarm	char	倾角X报警 0:正常 1:报警	否
obliguityYAlarm	char	倾角Y报警 0:正常 1:报警	否
windSpeedAlarm	char	风速报警 0:正常 1:报警	否
motor1Alarm	char	1号电机报警 0:正常 1:报警	否
motor2Alarm	char	2号电机报警 0:正常 1:报警	否
motor3Alarm	char	3号电机报警 0:正常 1:报警	否
topAlarm	char	防冲顶报警 0:正常 1:报警	否
fallAlarm	char	防坠器报警 0:正常 1:报警	否
bottomAlarm	char	下限位报警 0:正常 1:报警	否

请求示例


xxxxxxxxxx
{
    "devSn": "9E870423ECEC47699489083450F82D45",
    "backDoorState": 0,
    "bottomAlarm": 0,
    "dipAngleX": "0",
    "dipAngleY": "0",
    "driverIdCard": "String",
    "driverName": "String",
    "fallAlarm": 0,
    "floorError": 0,
    "floorNum": 0,
    "frontDoorState": 0,
    "gpsError": 0,
    "height": "10",
    "heightAlarm": 100,
    "heightError": 0,
    "heightPreAlarm": 0,
    "idError": 0,
    "isOnline": 0,
    "loading": "String",
    "loadRatio": "String",
    "maxLoad": "String",
    "motor1Alarm": 0,
    "motor2Alarm": 0,
    "motor3Alarm": 0,
    "noAlarm": 0,
    "noError": 0,
    "noPreAlarm": 0,
    "obliguityXAlarm": 0,
    "obliguityXError": 0,
    "obliguityXPreAlarm": 0,
    "obliguityYAlarm": 0,
    "obliguityYError": 0,
    "obliguityYPreAlarm": 0,
    "peopleCntAlarm": 0,
    "peopleCntError": 0,
    "peopleNumber": 0,
    "reciveTime": "2022-03-08 09:23:10",
    "runningState": 0,
    "speed": "0",
    "speedAlarm": 0,
    "speedError": 0,
    "speedPreAlarm": 0,
    "startTime": "2021-03-08 09:23:08",
    "topAlarm": 0,
    "weightAlarm": 0,
    "weightError": 0,
    "weightPreAlarm": 0,
    "windSpeed": "0",
    "windSpeedAlarm": 0,
    "windSpeedError": 0,
    "windSpeedPreAlarm": 0,
    "wirelessError": 0
}

响应结果：

失败：


xxxxxxxxxx
{
  "success": false,
  "message": "Incorrect equipment number",
  "code": 5000,
  "result": null,
  "timestamp": 1617264186112
}

成功：


xxxxxxxxxx
{
  "success": true,
  "message": "Operation succeeded！",
  "code": 200,
  "result": null,
  "timestamp": 1617264342406
}

2、添加升降机报警数据

接口描述：	添加升级机报警数据
请求URL:	/xmgl/lifterAlarm/add
请求方式:	POST
Content-Type：	application/json

请求参数：

字段	类型	说明	是否必传
devSn	String	设备识别码(平台生成的唯一识别码)	是
startTime	String	报警开始时间，时间格式如2021-03-08 09:23:08	是
endTime	String	报警结束时间，时间格式如2021-03-08 09:23:08	是
driverName	String	司机姓名	否
driverIdCard	String	司机身份证号	否
certification	String	特种作业号	否
peopleCntAlarm	char	人数报警 0:正常 1:报警	是
weightAlarm	char	载重报警 0:正常 1:报警	是
speedAlarm	char	速度报警 0:正常 1:报警	是
heightAlarm	char	高度报警 0:正常 1:报警	是
obliguityXAlarm	char	倾角X报警 0:正常 1:报警	是
obliguityYAlarm	char	倾角Y报警 0:正常 1:报警	是
windSpeedAlarm	char	风速报警 0:正常 1:报警	是
motor1Alarm	char	1号电机报警 0:正常 1:报警	是
motor2Alarm	char	2号电机报警 0:正常 1:报警	是
motor3Alarm	char	3号电机报警 0:正常 1:报警	是
topAlarm	char	防冲顶报警 0:正常 1:报警	是
fallAlarm	char	防坠器报警 0:正常 1:报警	是
bottomAlarm	char	下限位报警 0:正常 1:报警	是

请求示例：


xxxxxxxxxx
{
  "devSn" :"设备编号",
  "startTime" :"2023-07-17 16:30:10",
  "endTime" :"2023-07-17 16:55:10",
  "driverName" :"gu",
  "driverIdCard" :"520181200203204612",
  "certification" :"特种作业号",
  "heightAlarm" :1,
  "peopleCntAlarm" :1,
  "weightAlarm" :1,
  "speedAlarm" :1,
  "obliguityXAlarm" :1,
  "obliguityYAlarm" :1,
   "windSpeedAlarm" :1,
  "motor1Alarm" :1,
  "motor2Alarm" :1,
  "motor3Alarm" :1,
  "topAlarm" :1,
  "fallAlarm" :1,
  "bottomAlarm" :1
}

响应结果：

成功：


xxxxxxxxxx
{
  "success": true,
  "message": "操作成功！",
  "code": 200,
  "result": null,
  "timestamp": "1681814472197"
}

3、添加升降机工作循环数据

接口描述：	添加升级机工作循环数据
请求URL:	/xmgl/lifterWorkCycle/add
请求方式:	POST
Content-Type：	application/json

请求参数：

字段	类型	说明	是否必传
devSn	String	设备识别码(平台生成的唯一识别码)	是
startTime	String	开始时间，时间格式如2021-03-08 09:23:08	是
endTime	String	结束时间，时间格式如2021-03-08 09:23:08	是
workTime	String	工作时长,单位（s）	是
driverName	String	司机姓名	否
driverIdCard	String	司机身份证号	否
loading	float	本次工作循环最大载重(kg)	是
loadRatio	float	本次运行最大载重百分比	否
startHeight	float	开始运行高度(米)	是
stopHeight	float	停止运行高度(米)	是
runningState	char	运行状态 1：上升 2：下降	是
maxSpeed	float	最大运行速度（m/s）	否
dipAngleX	float	倾角X（°）	是
dipAngleY	float	倾角Y（°）	是
windSpeed	float	风速（m/s）	否
startFloorNum	Integer	开始楼层数	否
endFloorNum	Integer	结束楼层数	否
peopleNum	Integer	人数	否
peopleCntAlarm	char	人数报警 0:正常 1:报警	是
weightAlarm	char	载重报警 0:正常 1:报警	是
speedAlarm	char	速度报警 0:正常 1:报警	是
heightAlarm	char	高度报警 0:正常 1:报警	是
obliguityXAlarm	char	倾角X报警 0:正常 1:报警	是
obliguityYAlarm	char	倾角Y报警 0:正常 1:报警	是
windSpeedAlarm	char	风速报警 0:正常 1:报警	是
motor1Alarm	char	1号电机报警 0:正常 1:报警	是
motor2Alarm	char	2号电机报警 0:正常 1:报警	是
motor3Alarm	char	3号电机报警 0:正常 1:报警	是
topAlarm	char	防冲顶报警 0:正常 1:报警	是
fallAlarm	char	防坠器报警 0:正常 1:报警	是
bottomAlarm	char	下限位报警 0:正常 1:报警	是

请求示例：


xxxxxxxxxx
{
    "devSn": "设备编号",
    "startTime": "2023-07-17 16:30:10",
    "endTime": "2023-07-17 16:55:10",
    "workTime": 60,
    "driverName": "gu",
    "driverIdCard": "520181200203204612",
    "loading": 200,
    "loadRatio": 10,
    "startHeight": 5,
    "stopHeight": 10,
    "runningState": 1,
    "maxSpeed": 6,
    "dipAngleX": 10,
    "dipAngleY": 12,
    "windSpeed": 3,
    "startFloorNum": 1,
    "endFloorNum": 15,
    "peopleNum": 2,
    "peopleCntAlarm": 1,
    "speedAlarm": 1,
    "weightAlarm": 0,
    "heightAlarm": 1,
    "obliguityXAlarm": 1,
    "obliguityYAlarm": 1,
    "windSpeedAlarm": 1,
    "motor1Alarm": 1,
    "motor2Alarm": 1,
    "motor3Alarm": 1,
    "topAlarm": 1,
    "fallAlarm": 1,
    "bottomAlarm": 1
}

响应结果：

成功：


xxxxxxxxxx
{
  "success": true,
  "message": "操作成功！",
  "code": 200,
  "result": null,
  "timestamp": "1681814472197"
}

4、添加升降机违规数据

接口描述：	添加升降机违规数据
请求URL:	/xmgl/lifterViolation/add
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	说明	参数类型	是否必须	类型
devSn	设备编号	body	true	string
correctImage	整改图片	body	false	string
correctRemark	整改说明备注	body	false	string
correctTime	整改时间	body	false	string
pushPersonIds	推送人id字符串数组	body	false	string
rectificationPersonId	整改人id	body	false	int64
requestRectificationDate	要求整改时间	body	false	string
status	整改状态 1 待发起 2 待整改 3已整改	body	false	int32
violationDate	违规时间	body	false	string
violationImage	违规图片URL	body	false	string
violationNumber	报警人数	body	false	int32
violationType	违规类型	body	false	string

请求示例：


xxxxxxxxxx
{
    "correctImage": "",
    "correctRemark": "",
    "correctTime": "",
    "devSn": "设备编号",
    "pushPersonIds": "",
    "rectificationPersonId": 0,
    "requestRectificationDate": "",
    "status": 0,
    "violationDate": "",
    "violationImage": "/9j/4AAQSkZJRgABAQEAYABgAAD//gAUU29mdHdhcmU6IFNuaXBhc3Rl/9sAQwADAgIDAgIDAwMDBAMDBAUIBQUEBAUKBwcGCAwKDAwLCgsLDQ4SEA0OEQ4LCxAWEBETFBUVFQwPFxgWFBgSFBUU/9sAQwEDBAQFBAUJBQUJFA0LDRQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQU/8AAEQgAAQABAwEiAAIRAQMRAf/EAB8AAAEFAQEBAQEBAAAAAAAAAAABAgMEBQYHCAkKC//EALUQAAIBAwMCBAMFBQQEAAABfQECAwAEEQUSITFBBhNRYQcicRQygZGhCCNCscEVUtHwJDNicoIJChYXGBkaJSYnKCkqNDU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6g4SFhoeIiYqSk5SVlpeYmZqio6Slpqeoqaqys7S1tre4ubrCw8TFxsfIycrS09TV1tfY2drh4uPk5ebn6Onq8fLz9PX29/j5+v/EAB8BAAMBAQEBAQEBAQEAAAAAAAABAgMEBQYHCAkKC//EALURAAIBAgQEAwQHBQQEAAECdwABAgMRBAUhMQYSQVEHYXETIjKBCBRCkaGxwQkjM1LwFWJy0QoWJDThJfEXGBkaJicoKSo1Njc4OTpDREVGR0hJSlNUVVZXWFlaY2RlZmdoaWpzdHV2d3h5eoKDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uLj5OXm5+jp6vLz9PX29/j5+v/aAAwDAQACEQMRAD8AZRRRX9Zn8GH/2Q==",
    "violationNumber": 0,
    "violationType": ""
}

响应结果：

成功：


xxxxxxxxxx
{
  "success": true,
  "message": "操作成功！",
  "code": 200,
  "result": null,
  "timestamp": "1681814472197"
}

水表对接

1、上报水表实时的数据

接口描述：	上报水表实时的数据
请求URL:	/xmgl/callback/waterMeterRecord/save
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	说明	是否必须	类型
waterMeterNo	水表号	True	String
waterTonnage	用水吨数	True	float

请求例子：


xxxxxxxxxx
[
  {
    "waterMeterNo": "S3F023221231",
    "waterTonnage": 12,
    "gateStatus": 1
  }
]

响应结果：

成功：


xxxxxxxxxx
{
  "success": true,
  "message": "操作成功！",
  "code": 200,
  "result": null,
  "timestamp": "1681814472197"
}

失败：


xxxxxxxxxx
{
  "success": false,
  "message": "水表号waterMeterNo不存在",
  "code": 500,
  "result": null,
  "timestamp": "1682069656446"
}

2. 上报状态

接口描述：	上报状态
请求URL:	/xmgl/callback/waterMeterInfo/status
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	说明	是否必须	类型
online	在线状态（0.离线 1.在线）	True	Int
waterMeterNo	水表号	True	String
gateStatus	阀门状态（1.开 2.关）	True	int
deviceStatus	电信平台设备状态（0.已注册 1.已激活 2.已注销）	false	int

请求例子：


xxxxxxxxxx
{
    "waterMeterNo": "S3F023221212331",
    "online": 0,
    "gateStatus": 1,
    "deviceStatus": 1
}

响应结果：

成功：


xxxxxxxxxx
{
  "success": true,
  "message": "操作成功！",
  "code": 200,
  "result": null,
  "timestamp": "1681814472197"
}

失败：


xxxxxxxxxx
{
  "success": false,
  "message": "水表号waterMeterNo不存在",
  "code": 500,
  "result": null,
  "timestamp": "1682069656446"
}

电表对接

1.上报电表实时的数据

接口描述：	上报电表实时的数据
请求URL:	/xmgl/callback/ammeterRecord/save
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	说明	是否必须	类型
ammeterNo	电表号	True	String
degree	用电量	true	float

请求例子：


xxxxxxxxxx
[
  {
    "ammeterNo": "666777",
    "degree": 10.83
  }
]

响应结果：

成功：


xxxxxxxxxx
{
  "success": true,
  "message": "操作成功！",
  "code": 200,
  "result": null,
  "timestamp": "1681814472197"
}

失败：


xxxxxxxxxx
{
  "success": false,
  "message": "电表号ammeterNo不存在",
  "code": 500,
  "result": null,
  "timestamp": "1682069656446"
}

2. 上报状态

接口描述：	上报状态
请求URL:	/xmgl/callback/ammeter/status
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	说明	是否必须	类型
ammeterNo	电表号	true	String
online	在线状态（0.离线 1.在线）	true	Integer
gateStatus	阀门状态（1.开 2.关）	true	Integer
deviceStatus	电信平台设备状态（0.已注册 1.已激活 2.已注销）	false	Integer

请求例子：


xxxxxxxxxx
{
    "ammeterNo": "电表号",
    "online": 1,
    "gateStatus": 1,
    "deviceStatus": 1
}

响应结果：

成功：


xxxxxxxxxx
{
  "success": true,
  "message": "操作成功！",
  "code": 200,
  "result": null,
  "timestamp": "1681814472197"
}

失败：


xxxxxxxxxx
{
  "success": false,
  "message": "电表号ammeterNo不存在",
  "code": 500,
  "result": null,
  "timestamp": "1682069656446"
}

实名制系统对接

1 HTTP接口

数据对接通过http接口请求。

1.1 基本要求：

Http协议

接口采用HTTP协议。

本规范建议使用短连接的方式，每次调用使用新的Http连接。在数据交换的过程中，不可使用分包的形式，数据必须一次性返回。

接口要求

1.接口需要传递的数据采用JSON作为数据表达形式。

2.POST方式提交请求，json参数放在request body中（如果接口没有参数，json参数就是一个大括号：{}）。

3.字符集编码用UTF-8；

接口定义

带有变更（如：变更人员）两字的接口的定义是：根据接口规定的主键，已有数据则执行修改，没有则新增。

2 劳务公司接口

2.1 获取企业类型

2.1.1 接口描述

获取企业类型

2.1.2 接口定义

接口URL	/xmgl/itbgp/api/getCompanyType
接口请求方式	POST

2.1.3 请求参数

无

2.1.4 响应参数

参数名称	参数描述	参数类型	备注
id	id	int
companyTypeName	企业类型名称	String
msg	错误信息	String
status	状态码	String	1表示成功；其余表示失败
响应参数示例
{ "data": [ { "id": 1, "companyTypeName": "监理单位",} ], "msg": "信息", "status": "1"}

2.2 变更劳务公司

2.2.1 接口描述

变更劳务公司

2.2.2 接口定义

接口URL	/xmgl/itbgp/api/modCompany
接口请求方式	POST

2.2.3 请求参数

参数名称	参数描述	参数类型	是否必填	备注
socialCode	统一社会信用代码	String	是	socialCode唯一确定此劳务公司
companyName	企业名称	String	是
companyTypeId	企业类型	int	否	通过获取企业类型接口获取ID
companyLegalPerson	法定代表人	String	是
legalPersonTel	法人电话	String	否
companyAddress	企业地址	String	否
companyLinkMobile	企业联系电话	String	否
companySafeAllow	企业安全生产许可证	String	否
companyPropertyId	单位性质	int	否	1.国有企业 2三资企业 3集体企业 4私营企业
businessNumber	营业执照注册号	String	否
companyEmail	注册资金	String	否
qualificationNumber	资质证书号	String	否
companyQualificationUrl	企业资质图片http地址	String	否
businessLicenseRegisterCode	营业执照注册号	String	否
businessLicenseEndDate	营业执照截止日期	String	否	格式：2019-05-28
请求参数示例

2.2.4 响应参数

参数名称	参数描述	参数类型	备注
msg	错误信息	String
status	状态码	String	1表示成功；其余表示失败
响应参数示例
{ "msg": "信息", "status": "1"}

2.3 删除劳务公司

2.3.1 接口描述

删除劳务公司

2.3.2 接口定义

接口URL	/xmgl/itbgp/api/delCompany
接口请求方式	POST

2.3.3 请求参数

参数名称	参数描述	参数类型	是否必填
socialCode	统一社会信用代码	string	是
请求参数示例

2.3.4 响应参数

参数名称	参数描述	参数类型	备注
msg	错误信息	String
status	状态码	String	1表示成功；其余表示失败
响应参数示例
{ "msg": "信息", "status": "1"}

2.4 项目绑定劳务公司

2.4.1 接口描述

项目绑定劳务公司

2.4.2 接口定义

接口URL	/xmgl/itbgp/api/bindCompany
接口请求方式	POST

2.4.3 请求参数

参数名称	参数描述	参数类型	是否必填	备注
socialCode	统一社会信用代码	String	是	socialCode唯一确定此劳务公司
projectCode	项目编码	String	是
companyTypeId	企业类型	int	是	通过获取企业类型接口获取ID
isBind	绑定状态	int	是	1：绑定；0：解除绑定
请求参数示例

2.4.4 响应参数

参数名称	参数描述	参数类型	备注
msg	错误信息	String
status	状态码	String	1表示成功；其余表示失败
响应参数示例
{ "msg": "信息", "status": "1"}

2.5 获取劳务公司

2.5.1 接口描述

获取项目下的劳务公司

2.5.2 接口定义

接口URL	/xmgl/itbgp/api/getCompany
接口请求方式	POST

2.5.3 请求参数

参数名称	参数描述	参数类型	是否必填	备注
projectCode	项目编码	String	是
socialCode	统一社会信用代码	String	否
companyName	公司名称	String	否	模糊匹配
请求参数示例

2.5.4 响应参数

参数名称	参数描述	参数类型	备注
data			返回的字段含义请查看：变更劳务公司
msg	错误信息	String
status	状态码	String	1表示成功；其余表示失败
响应参数示例
{ "data": { "total": 287, "data": [{ "companyName": "恒捷", "registerPersonPhoneTel": "", "companySafeAllow": "", "bankName": "", "businessLicenseEndDate": null, "title": "", "companyQualificationUrl": "", "companyEmail": "", "registeredCapital": "", "bgimage": "", "logo": "", "companyLinkMobile": null, "businessLicenseRegisterCode": "", "legalPersonTel": "", "bankCode": "", "companyLegalPerson": "张龙钱", "businessNumber": null, "companyId": 205, "companyAddress": "", "companyPropertyId": null, "companyTypeId": 115, "qualificationNumber": "", "socialCode": "916411006943040406", "lastUpdateTime": "2020-05-27 14:29:32" }] }, "msg": "信息", "status": "1"}

3 班组接口

3.1 变更班组

3.1.1 接口描述

变更班组

3.1.2 接口定义

接口URL	/xmgl/itbgp/api/modGroup
接口请求方式	POST

3.1.3 请求参数

参数名称	参数描述	参数类型	是否必填	备注
groupName	班组名称	string	是	在一个项目下，班组名称必须唯一
newGroupName	执行修改时，新的班组名称	string	否
idCard	班组负责人身份证	string	否	如果传入班组负责人身份证，必须保证人员存在，否则班组将会创建失败
projectCode	项目编码	String	是
socialCode	班组所属的劳务公司统一社会信用代码	string	是
请求参数示例

3.1.4 响应参数

参数名称	参数描述	参数类型	备注
msg	错误信息	String
status	状态码	String	1表示成功；其余表示失败
响应参数示例
{ "msg": "信息", "status": "1"}

3.2 删除班组

3.2.1 接口描述

删除班组

3.2.2 接口定义

接口URL	/xmgl/itbgp/api/delGroup
接口请求方式	POST

3.2.3 请求参数

参数名称	参数描述	参数类型	是否必填	备注
groupName	班组名称	string	是	在一个项目下，班组名称必须唯一
projectCode	项目编码	string	是
请求参数示例

3.2.4 响应参数

参数名称	参数描述	参数类型	备注
msg	错误信息	String
status	状态码	String	1表示成功；其余表示失败
响应参数示例
{ "msg": "信息", "status": "1"}

3.3 获取班组

3.3.1 接口描述

获取班组

3.3.2 接口定义

接口URL	/xmgl/itbgp/api/getGroup
接口请求方式	POST

3.3.3 请求参数

参数名称	参数描述	参数类型	是否必填	备注
projectCode	项目编码	String	是
groupName	班组名称	String	否	模糊匹配
startTime	最后更新时间：开始时间	String	否	格式：2020-03-10 00:00:00
endTime	最后更新时间：结束时间	String	否	格式：2020-03-10 23:59:59
pageIndex	当前页	int	否	默认1
pageSize	每页大小	int	否	默认500
请求参数示例

3.3.4 响应参数

参数名称	参数描述	参数类型	备注
data			返回的字段含义请查看：变更班组
msg	错误信息	String
status	状态码	String	1表示成功；其余表示失败
响应参数示例
{ "data": { "total": 287, "data": [{ "idCard": "530102199003076071", "companyName": "恒捷", "groupId": 2038, "groupName": "钢筋工-邱义杰", "workerName": "邱义杰", "socialCode": "916411006943040406", "lastUpdateTime": "2020-05-29 14:58:18" }] }, "msg": "信息", "status": "1"}

4 工种接口

4.1 获取工种

4.0.1 接口描述

获取工种

4.0.2 接口定义

接口URL	/xmgl/itbgp/api/getWorkerType
接口请求方式	POST

4.0.3 请求参数

参数名称	参数描述	参数类型	是否必填	备注
projectCode	项目编码	String	是
pageIndex	页数	int	否	默认1
pageSize	每页大小	int	否	默认500
请求参数示例

4.0.4 响应参数

参数名称	参数描述	参数类型	备注
typeId	工种ID	int
typeName	工种名称	string
classify	工种分类	int	0普通工种；1特殊工种
msg	错误信息	String
status	状态码	string	1表示成功；其余表示失败
响应参数示例
{ "data": [ { "typeId": 101, "typeName": "混凝土工", "classify": 0 } ], "msg": "信息", "status": "1"}

5 人员接口

5.1 上传图片

5.1.1 接口描述

变更人员、上报通行记录接口，人脸照片参数传的是http地址，因此在调用这两个接口前先调用上传图片，获取到照片http地址（或文件名称）

5.1.2 接口定义

接口URL	/xmgl/itbgp/api/uploadImg
接口请求方式	POST

5.1.3 请求参数

参数名称	参数描述	参数类型	是否必填	备注
type	图片类型	int	是	1人脸照片 2人员通行抓拍照片（通行抓拍照片必须传入类型2，否则照片可能会被丢弃。非通行抓拍照片，可以共用类型1）
imgData	图片	string	是	Base64字符串
请求参数示例

5.1.4 响应参数

参数名称	参数描述	参数类型	备注
msg	错误信息	String
status	状态码	String	1表示成功；其余表示失败
url	图片http下载地址（或文件名称）	String
响应参数示例
{ "url": "92f1dfea.jpg","msg": "信息", "status": "1"}

5.2 变更人员(保存或修改人员数据)

5.2.1 接口描述

变更人员

5.2.2 接口定义

接口URL	/xmgl/itbgp/api/modWorker
接口请求方式	POST

5.2.3 请求参数

参数名称	参数描述	参数类型	是否必填	备注
idCard	身份证号码	string	是	由身份证号码唯一确定此人员
projectCode	人员所属的项目编码	string	是
name	姓名	string	是
phoneNumber	手机号码	string	否
personType	人员类型	int	是	1、劳务人员，2、管理人员
photoUrl	人脸照片http地址	string	是
socialCode	人员所属的劳务公司统一社会信用代码	string	是
groupName	人员所属的班组名称	string	否	来源：变更班组
workerTypeName	人员所属的工种名称	string	劳务人员的班组和工种必填	钢筋工钢结构混凝土工泥水工木工油漆工模板工桩基工防水工架子工水电安装消防空调外墙涂料铝合金门窗外墙施工人员园林工司机特殊工种机电安装工其他工种
inServiceType	在职状态	int	是	1在职 2离职
duty	管理人员职务类型	int	否	//甲方7：城市总经理40：工程分管领导30：项目合伙人8：工程部负责人5：万科项目经理6：万科现场工程师31：万科安全工程师17：万科员工-工程部9：万科员工-其它部门12：区域合伙人13：安委会委员 //监理2：监理总监36：总监代表3：安全监理20：土建监理21：水电监理24：其他监理人员 //乙方4：土建总包项目经理32：土建总包项目副经理33：土建总包项目技术总工26：土建总包生产经理27：土建总包安全主任1：土建总包安全员19：土建总包现场管理人员45：精装总包项目经理46：精装总包生产经理34：分包项目经理18：分包其他管理人员25：总包其他人员11：其他人员
sex	性别	int	否	1男 0女
nativePlace	籍贯	string	否
nationId	民族	string	否
dateOfBirth	生日	string	否	格式：2019-02-28
nowPlace	现在住址	string	否
educational	教育程度	int	否	1小学、2初中、3中专、4高中、5大专、6本科、7研究生、8博士、9博士后
marry	婚否	int	否	1未婚 2已婚 3离异 4丧偶
politicsStatus	政治面貌	int	否	1.中共党员 2.共青团团员 3.普通居民 4.其他党派人士
emergentPerson	紧急联系人	string	否
emergentPhone	紧急联系电话	string	否
idCardUpPhotoUrl	身份证正面照片http地址	string	否
idCardDownPhotoUrl	身份证反面照片http地址	string	否
idCardBigPhotoUrl	身份证头像	string	否
idCardEndDate	身份证有效期	string	否	格式：2019-02-28
issuingAuthorityForIdcard	身份证签发机关	string	否
enterDate	进场日期	string	否	格式：2019-11-08
idCardForever	身份证长期有效	int	否	0否，1是
createTime	人员创建时间	string	否	格式：2020-02-12 16:10:06
validateStatus	实名制状态，0、未实名 1、已实名	int	否	默认0
onlyCreate	是否只执行新增	int	否	0否；1是；默认0如果是，只执行新增；对于已经存在的人员，不做变更操作
请求参数示例

5.2.4 响应参数

参数名称	参数描述	参数类型	备注
msg	错误信息	String
status	状态码	String	1表示成功；其余表示失败
响应参数示例
{ "msg": "信息", "status": "1"}

5.3 删除人员

5.3.1 接口描述

删除人员

5.3.2 接口定义

接口URL	/xmgl/itbgp/api/delWorker
接口请求方式	POST

5.3.3 请求参数

参数名称	参数描述	参数类型	是否必填	备注
idCard	身份证号码	string	是	由身份证号码唯一确定此人员
projectCode	人员所属的项目编码	string	是
请求参数示例

5.3.4 响应参数

参数名称	参数描述	参数类型	备注
msg	错误信息	String
status	状态码	String	1表示成功；其余表示失败
响应参数示例
{ "msg": "信息", "status": "1"}

5.4 获取人员

5.4.1 接口描述

获取人员

5.4.2 接口定义

接口URL	/xmgl/itbgp/api/getWorker
接口请求方式	POST

5.4.3 请求参数

参数名称	参数描述	参数类型	是否必填	备注
projectCode	项目编码	String	是
inServiceType	在职状态	int	否	0不限；1在职；2离职（默认1）
personType	人员类型	int	否	1、劳务人员，2、管理人员
name	姓名	String	否	模糊匹配
idCard	人员身份证号	String	否	后缀匹配
startTime	人员最后更新时间：开始时间	String	否	格式：2020-03-10 00:00:00
endTime	人员最后更新时间：结束时间	String	否	格式：2020-03-10 23:59:59
isDel	获取被删除人员	int	否	0否，1是，默认0如果为1，startTime、endTime必须传入，只能获取一段时间内被删除人员
pageIndex	当前页	int	否	默认1
pageSize	每页大小	int	否	默认500
请求参数示例

5.4.4 响应参数

参数名称	参数描述	参数类型	备注
data			返回的字段含义请查看：变更人员
msg	错误信息	String
status	状态码	String	1表示成功；其余表示失败
响应参数示例
{ "data": { "total": 287, "data": [{ "idCard": "330101190001012854", "companyName": "中建三局集团有限公司", "marry": null, "idCardForever": 1, "emergentPerson": null, "politicsStatus": null, "photoUrl": "https://zhihui.blob.core.chinacloudapi.cn/zhgdfile1/202003/1897f4749f894c878ad2c2d9da7708fa.jpg", "workerTypeName": "外墙施工人员", "personType": 1, "inServiceType": 1, "educational": null, "validateStatus": 0, "idCardUpPhotoUrl": null, "sex": 1, "nationId": null, "dateOfBirth": "2000-01-01", "idCardBigPhotoUrl": null, "emergentPhone": null, "groupName": "钢筋工组", "phoneNumber": "18808080909", "idCardDownPhotoUrl": null, "createTime": "2020-05-11 14:01:42", "name": "张三", "duty": null, "nativePlace": null, "issuingAuthorityForIdcard": null, "idCardEndDate": null, "socialCode": "91420000757013137P", "lastUpdateTime": "2020-05-13 14:48:10" }] }, "msg": "信息", "status": "1"}

5.5 上报通行记录

5.5.1 接口描述

上报通行记录。上报前必须先上传通行设备，否则通行记录将会保存失败。

5.5.2 接口定义

接口URL	/xmgl/itbgp/api/passRecord
接口请求方式	POST

5.5.3 请求参数

参数名称	参数描述	参数类型	是否必填	备注
idCard	身份证号（项目里面唯一，idCard和attendanceNumber必须要传其中一个）	String	是
attendanceNumber	考勤考号（项目里面唯一，idCard和attendanceNumber必须要传其中一个）	String	是
projectCode	项目编码	String	是
passTime	通行时间	String	是	格式：2019-06-06 09:53:12
direction	通行方向	int	是	1:进 2出
passType	通行方式	int	是	1：IC卡；2：人脸识别；3：指纹识别；5：二维码；6：蓝牙
devCode	通行设备编码	String	是	务必保证已经上传通行设备，如果设备不存在，通行记录将会被丢弃
faceUrl	人脸通行抓拍照片http地址	String	否
请求参数示例

5.5.4 响应参数

参数名称	参数描述	参数类型	备注
msg	错误信息	String
status	状态码	String	1表示成功；其余表示失败
响应参数示例
{ "msg": "信息", "status": "1"}

5.6 获取通行记录

5.6.1 接口描述

获取通行记录

5.6.2 接口定义

接口URL	/xmgl/itbgp/api/getPassRecord
接口请求方式	POST

5.6.3 请求参数

参数名称	参数描述	参数类型	是否必填	备注
projectCode	项目编码	String	是
idCard	人员身份证号	String	否
startTime	通行开始时间	String	是	格式：2020-03-10 00:00:00
endTime	通行结束时间	String	是	格式：2020-03-10 23:59:59（按项目获取通行记录，通行时间只能在一天之内）
pageIndex	当前页	int	是	默认1
pageSize	每页大小	int	是	默认500
请求参数示例

5.6.4 响应参数

参数名称	参数描述	参数类型	备注
passTime	通行时间	string
direction	通行方向	int	1:进 2出
passType	通行方式	int	1：IC卡；2：人脸识别；3：指纹识别；5：二维码；6：蓝牙
devCode	通行设备编码	string
faceUrl	人脸通行抓拍照片http地址	string
idCard	通行人员身份证号码	string
msg	错误信息	String
status	状态码	String	1表示成功；其余表示失败
响应参数示例
{ "data": { "total": 287, "data": [{ "passTime": "2020-03-11 12:18:50", "direction": 1, "passType": 2, "devCode": "xnvkc001", "idCard": "330101190001010000", "faceUrl": "http://40.73.68.142:8099/v1/image/2/20200311/363729f54d72883fea1b1a772be2a8e9" }] }, "msg": "信息", "status": "1"}

5.7 添加实名认证

5.7.1 接口描述

添加实名认证

5.7.2 接口定义

接口URL	/xmgl/itbgp/api/addRealName
接口请求方式	POST

5.7.3 请求参数

参数名称	参数描述	参数类型	是否必填
idCards	已实名的人员身份证号码，多个以英文逗号分隔	string	是
projectCode	项目编码	String	是
请求参数示例

5.7.4 响应参数

参数名称	参数描述	参数类型	备注
msg	错误信息	String
status	状态码	String	1表示成功；其余表示失败
响应参数示例
{ "msg": "信息", "status": "1"}

5.8 通过项目SN查询全部人员信息

5.8.1 接口描述

通过项目SN查询全部人员信息

5.8.2 接口定义

接口URL	/xmgl/workerInfo/selectPersonList
接口请求方式	GET

5.8.3 请求参数

参数名称	参数描述	参数类型	是否必填	备注
projectSN	项目编码	String	是	项目SN
请求参数示例

5.8.4 响应参数

参数名称	参数描述	参数类型	备注
msg	错误信息	String
status	状态码	String	1表示成功；其余表示失败
响应参数示例
{ "msg": "信息", "status": "1"}

5.9 查询劳务人员黑名单列表

接口描述：	查询劳务人员黑名单列表
请求URL:	/xmgl/workerBlacklist/list
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	说明	参数类型	是否必须	类型
pageNo	第几页	body	true	int
pageSize	每页显示条数	body	true	int
projectSn	项目SN	body	true	string

响应参数：

参数名称	说明	类型
id	id	string
addReason	加入黑名单原因	string
addTime	加入黑名单日期	string
projectSn	项目SN	string
idCard	身份证号	string
type	类型：1证书过期2合同过期3保险过期	int
workerId	人员ID	string
workerName	姓名	string
attendanceNumber	考勤考号	string

请求示例：


xxxxxxxxxx
{
    "projectSn": "B717CB992D054A878FDAFB4A5C169947",
    "pageNo": 1,
    "pageSize": 10
}

响应示例：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": {
        "records": [
            {
                "id": "1747469196277678081",
                "projectSn": "B717CB992D054A878FDAFB4A5C169947",
                "workerId": "1714467284868526081",
                "workerName": "刘世会",
                "idCard": "512528197501252765",
                "addReason": "证件已到期",
                "reason": "证件已到期",
                "addTime": "2024-01-17 12:01:37",
                "createTime": "2024-01-17 12:01:37",
                "type": 1,
                "attendanceNumber": "512528197410021910"
            }
        ]
    }
}

6 设备接口

6.1 上传通行设备

6.0.1 接口描述

上传通行设备

6.0.2 接口定义

接口URL	/xmgl/itbgp/api/uploadPassDev
接口请求方式	POST

6.0.3 请求参数

参数名称	参数描述	参数类型	是否必填	备注
devCode	设备编码	string	是
devName	设备名称	string	是
devIp	设备IP	string	否
devPort	设备端口	string	否
direction	通行方向	int	是	1:进 2出
devInstallDate	设备安装时间	string	否
projectCode	项目编码	string	是
isOnline	设备在线状态（用下面的心跳接口）	int	否	0离线；1在线
请求参数示例

6.0.4 响应参数

参数名称	参数描述	参数类型	备注
msg	错误信息	String
status	状态码	String	1表示成功；其余表示失败
响应参数示例
{ "msg": "信息", "status": "1"}

6.2 发送通行设备心跳

6.0.1 接口描述

发送人脸设备心跳（超过30分钟设备离线）

6.0.2 接口定义

接口URL	/xmgl/itbgp/api/sendHeartbeat
接口请求方式	POST

6.0.3 请求参数

参数名称	参数描述	参数类型	是否必填
devCode	设备编码	string	是
projectCode	项目编码	string	是
请求参数示例
{"devCode":"劳务设备001","projectCode":"B717CB992D054A878FDAFB4A5C169947"}

6.0.4 响应参数

参数名称	参数描述	参数类型	备注
msg	错误信息	String
status	状态码	String	1表示成功；其余表示失败
响应参数示例
{ "msg": "信息", "status": "1"}

考勤设备对接（dg）

1时间同步

接口地址


xxxxxxxxxx
/init

请求类型 GET

=============================

本接口仅用于时间同步，请按照最后的json回复数据就可以

注意：

time 为时间戳，单位是秒，格式是数字，不是字符串

============================

请求参数

参数	类型	是否必须	说明
deviceId	string	是	设备编号

返回类型 JSON

返回参数（）

参数	类型	是否必须	说明
time	long	是	时间

返回示例


xxxxxxxxxx
{
    "success": true,
    "code": 0,
    "message": "success",
    "time": 1583137849,
    "data": {},
    "event": "init"
}

2下载白名单（拉取允许通行人员信息）

接口地址


xxxxxxxxxx
/workers

注：只需要实现全量更新，设备这边是全量更新的，人员删除后直接从白名单中删除就行，比如之前有3个人，后面xxx人员退场了，白名单就返回剩下的两个人就行，因为默认都是全量的，实现了全量就可以了

请求类型

GET

请求参数

参数	类型	是否必须	说明
deviceId	string	是	设备编号

返回类型

JSON

返回参数

参数	类型	是否必须	说明
data	array	是	工人数据
data.name	string	是	工人姓名
data.workerId	string	是	工人编号
data.photo	string	是	工人照片
data.update	string	是	最后更新时间，该时间为人员信息变更时间，当设备内存储的时间与这个值不一致时，就会自动更新设备内的人员信息。
data.projectId	string	是	项目id
data.idCardNumber	string	否	身份证号，未加密明文传输

请求示例


xxxxxxxxxx
http://ip:端口号/service-address/workers?deviceId=1&update=1702536336

返回示例


xxxxxxxxxx
{
    "success": true,
    "code": 0,
    "message": "success",
    "time": "1702538047",
    "data": [
        {
            "projectId": "B717CB992D054A878FDAFB4A5C169947",
            "del": "0",
            "update": "1702536336",
            "name": "肖开勇",
            "idCardNumber": "511521198212026939",
            "workerId": "1714467284801417219",
            "photo": "http://192.168.34.221:30002/image/654c8f050035c384d62fa038.jpg"
        }
    ],
    "event": "workers"
}

3.考勤照片上传

接口地址


xxxxxxxxxx
/photo

请求类型 POST

请求参数

body

参数	类型	是否必须	说明
deviceId	string	是	设备编号
base64	string	是	图片base64编码
workerId	string	是	系统中的人员编号
time	string	是	通行时间。毫秒时间戳
temp	string	否	体温
direction	string	是	进出方向。默认 in in：进；out：出
type	string	否	通行类型。默认 face face 人脸， idcard 身份证， health_qr 健康码， pass_qr 通行二维码

返回类型 JSON

返回参数

参数	类型	是否必须	说明
data	object	是
data.path	string	是	图片地址

请求示例


xxxxxxxxxx
{
    "deviceId": "1",
    "workerId": "1714467284801417219",
    "time": "1702538047000",
    "temp": "37",
    "direction": "in",
    "type": "face",
    "base64": "/9j/4AAQSkZJRgABAQEAYABgAAD//gAUU29mdHdhcmU6IFNuaXBhc3Rl/9sAQwADAgIDAgIDAwMDBAMDBAUIBQUEBAUKBwcGCAwKDAwLCgsLDQ4SEA0OEQ4LCxAWEBETFBUVFQwPFxgWFBgSFBUU/9sAQwEDBAQFBAUJBQUJFA0LDRQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQU/8AAEQgAAQABAwEiAAIRAQMRAf/EAB8AAAEFAQEBAQEBAAAAAAAAAAABAgMEBQYHCAkKC//EALUQAAIBAwMCBAMFBQQEAAABfQECAwAEEQUSITFBBhNRYQcicRQygZGhCCNCscEVUtHwJDNicoIJChYXGBkaJSYnKCkqNDU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6g4SFhoeIiYqSk5SVlpeYmZqio6Slpqeoqaqys7S1tre4ubrCw8TFxsfIycrS09TV1tfY2drh4uPk5ebn6Onq8fLz9PX29/j5+v/EAB8BAAMBAQEBAQEBAQEAAAAAAAABAgMEBQYHCAkKC//EALURAAIBAgQEAwQHBQQEAAECdwABAgMRBAUhMQYSQVEHYXETIjKBCBRCkaGxwQkjM1LwFWJy0QoWJDThJfEXGBkaJicoKSo1Njc4OTpDREVGR0hJSlNUVVZXWFlaY2RlZmdoaWpzdHV2d3h5eoKDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uLj5OXm5+jp6vLz9PX29/j5+v/aAAwDAQACEQMRAD8AZRRRX9Zn8GH/2Q=="
}

返回示例


xxxxxxxxxx
{
    "success": true,
    "code": 0,
    "message": "success",
    "time": "1702539974",
    "data": {
        "path": "http://192.168.34.221:30002/image/657ab2c6b3f8afbc3c4feddd.jpeg"
    },
    "event": "photo"
}

4.照片质量反馈

接口地址


xxxxxxxxxx
/quality

请求类型 POST

请求参数

body

参数	类型	是否必须	说明
deviceId	string	是	设备编号
data	object	是	数组
data.workerId	string	是	系统中的人员编号
data.name	string	否	人员
data.plat	string	否	平台
data.msg	string	是	信息
data.code	string	是	错误号

错误码	说明
0	成功
1	没有照片
2	入库失败
3	与 XXX 相似度高
4	下载失败
5	照片太大
6	其他

返回类型 JSON

返回参数

参数	类型	是否必须	说明
data	object	是
data.workerId	string	是	人员id

返回示例


xxxxxxxxxx
{
  "success": true,
  "code": 0,
  "message": "success",
  "time": 1583137489,//单位s
  "data": [
    {
      "workerId": "121212"
    }
  ],
  "event": "quality"
}

配电箱对接

1、添加配电箱实时数据

接口描述：	添加配电箱实时数据
请求URL:	/xmgl/electricalData/add
请求方式:	POST
Content-Type：	application/json

请求参数：

字段	说明	是否必传
devSn	设备编号(平台生成的唯一识别码)	是
uploadTime	上传时间，时间格式如2021-03-08 09:23:08	是
voltageA	电压A	是
voltageB	电压B	否
voltageC	电压C	否
phaseCurrentA	电流A	是
phaseCurrentB	电流B	否
phaseCurrentC	电流C	否
electricLeakage	漏电流	是
cableTemperatureA	A相温度	是
cableTemperatureB	B相温度	否
cableTemperatureC	C相温度	否
ambientTemperature	环境温度	否

请求示例：


xxxxxxxxxx
{
    "devSn": "1",
    "uploadTime": "2023-07-17 14:25:08",
    "voltageA": 401,
    "voltageB": 400,
    "voltageC": 400,
    "phaseCurrentA": 500,
    "phaseCurrentB": 400,
    "phaseCurrentC": 400,
    "electricLeakage": 400,
    "cableTemperatureA": 501,
    "cableTemperatureB": 400,
    "cableTemperatureC": 400,
    "ambientTemperature": 400
}

响应结果：

成功：


xxxxxxxxxx
{
  "success": true,
  "message": "Operation succeeded！",
  "code": 200,
  "result": null,
  "timestamp": 1617264342406
}

临边防护网对接

1.新增临边防护-设备实时数据（联睿科对接）

接口描述：	新增临边防护-设备实时数据（联睿科对接）
请求URL:	/xmgl/fpdcd/lrk/add
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	说明	是否必须	类型
uuid	设备id	True	String
time	上传时间（yyyyMMddHHmmssSSS：20230417162619836）	True	String
current	数据	True	Current

Current参数：

参数名称	说明	是否必须	类型
battery	剩余电量百分比(0-100)	True	Int
proximity	人员靠近 1-正常；2-入侵；3-正常入侵	True	Int
antiCross	防翻越 1-正常；2-报警；3-失效	True	Int
portStatus	线锁状态	True	PortStatus
magStatus	磁锁状态	True	MagStatus

PortStatus参数：

参数名称	说明	是否必须	类型
port1	线锁1 状态 1-正常；2-断开；3-正常断开	True	Int
port2	线锁1 状态 1-正常；2-断开；3-正常断开	True	Int

magStatus参数：

参数名称	说明	是否必须	类型
magLock1	磁锁1 状态 1-正常；2-报警；3-失效	True	Int
magLock2	磁锁1 状态 1-正常；2-报警；3-失效	True	Int

请求例子：


xxxxxxxxxx
[
  {
    "current": {
      "antiCross": 3,
      "battery": 80,
      "magStatus": {
        "magLock1": 2,
        "magLock2": 2
      },
      "portStatus": {
        "port1": 2,
        "port2": 2
      },
      "proximity": 2
    },
    "interval": 86400,
    "metadata": {
      "deviceCode": "LB23010144",
      "nickname": "LB23010144",
      "positionGPS": "(E0,N0)",
      "projectCode": "3158",
      "projectName": "中建四局",
      "type": "DEV_LBFH"
    },
    "time": "20230417162619836",
    "uuid": "LB23010144"
  }
]

响应结果：

成功：


xxxxxxxxxx
{
  "success": true,
  "message": "操作成功！",
  "code": 200,
  "result": null,
  "timestamp": "1681814472197"
}

临边防护(无网)对接

1、临边防护(无网)上传数据-（艾礼安云平台设备状态信息订阅）

（1）描述：报警主机在发生状态改变、报警时，主动向第三方平台上传相关信息。

只有设备状态变化（在线/离线）时才会推送数据，推送失败不会重试。布防（在线）：alarm=0，state=布防离线：alram=0,state=故障

（2）订阅地址：/xmgl/frontierProtectionNoNetData/alaDeviceSubscribe

（3）调用方式：POST

（4）参数说明

参数	类型	位置	描述
deviceid	String	body	设备ID
devicename	String	body	设备名称
type	String	body	设备类型01:AL-238G02: AL-238S03:其他
address	String	body	安装位置
alarm	int	body	0:表示状态；1：表示报警；2表示其他
state	String	body	状态，内容：布防、撤防、SOS、盗警、交流电故障等
zone	String	body	防区编号
zonename	String	body	防区内容
time	String	body	时间戳（具体到秒）
number	String	body	事件序号（00-FF）

（5）携带头域信息：application/json

（6）JSON举例：

{"deviceid":"0123456789","devicename":"嘉华公司","type":"01","address":"深圳市大浪街道华宁路88号","alarm": "0","state": "布防","zone": "01","zonename": "研发室","time": "1531990161","number": "01"}

响应

0：表示成功

1：表示失败

联睿科-基坑数据推送标准_v1（钢结构自动化监测系统、高边坡）

1、推送方式

采用HTTP方式推送推送

请求URL：

基坑数据：/api/v1/events
钢结构自动化监测系统：/xmgl/steelStructureCurrentData/lrk/add
高边坡：/xmgl/highSlopeCurrentData/lrk/add

请求方式：POST

认证方式：

认证方式使用： 'Bearer Token'(即在http的header添加Authorization)

Token需要根据厂商信息和项目信息生成

2、数据格式

数据采用JSON格式封装, JSON字符使用UTF-8编码。

数据包含必须字段和设备相关字段。

设备相关字段分实时数据和静态数据，每次数据至少包含其一。支持一次推送多个设备的数据。

数据参考格式如下:


xxxxxxxxxx
[
    {
        "uuid": "设备标识1",
        "time": "数据时间",
        "interval": "数据周期",
        "current":
        {
            实时数据 ...
        },
        "metadata":
        {
            静态数据 ...
        }
    },
    {
        "uuid": "设备标识2",
        "time": "数据时间",
        "interval": "数据周期",
        "current":
        {
            实时数据 ...
        },
        "metadata":
        {
            静态数据 ...
        }
    }
]

2.1 、必须数据

参数名称	类型	必填	描述	限制
uuid	String	是	设备标识	同一项目唯一
time	String	是	数据采集时间, 格式YYYYMMddHHmmSSzzz	格式见下文说明
interval	Interger	是	数据采集周期, 即下次数据上传间隔	单位s

时间格式说明(时区UTC+8):

YYYY ：日期年，如 2016 表示 2016 年;
MM ：日期月，如09 表示 9 月;
dd ：日期日，如23 表示 23 日;
HH ：时间小时，24小时制。如 22 表示 22 点;
mm ：时间分钟，如 05 表示 5 分;
SS ：时间秒，如 59 表示 59 秒;
zzz ：时间毫秒，如 500 表示 500 毫秒;

2.2 、基坑设备相关字段

基坑数据模型版本: 1.0

注: 以'_'开头的字段表示子字段

2.2.1 、实时数据

参数名称	类型	必填	名称	描述
battery	Float	否	电池电量	电量百分比(0-100)
calcValue	Object	否	计算值	单位根据监测类型
_value	Float	否	计算值	-
_variation	Float	否	变化值	-
_rateChange	Float	否	变化速率	-
pointAlarmStatus	Object	否	报警状态
_occurTime	Long	否	报警时间	时间戳
_alarmState	Integer	否	报警状态	报警状态 1.正常 2.超报警 3.超控制 4.变化速率报警

2.2.2 、静态数据

参数名称	类型	必填	名称	描述
nickname	String	否	测点昵称	-
deviceCode	String	否	设备编号	-
projectCode	String	否	项目编号	-
monitorTypeCode	String	否	监测类型	详见监测类型映射关系表
type	String	否	设备类型	-
gps	Object	否	GPS位置	-
_lng	Float	否	经度	-
_lat	Float	否	纬度	-

3、数据示例

3.1、请求示例


x
POST /api/v1/events HTTP/1.1

Host: 127.0.0.1:8900

Content-Type: application/json

Authorization: Bearer

eyJhbGciOiJIUzI1NiIsImlhdCI66TUynTY1NjQ4MywiZXhwIjoxNTc3ODQyMDgzLjB9.eyJ2IjoiMSIsImkiaiJiMzFhY2U

yNC01MTk1LTExZTgtOTJiNi0zNGY2NGI2NDkzMWMiLCJ0IjoiU3RhbmRhcmQiLCJqIjoic3RkMSIsInMiOjE1MjU2MjI0MDA

uMCwiayI68ntcIm1cIbpcIkVudmlyb25tZW51CCJ9Nn0.nDdiDovoik9xcC_u2PmDdKpFIaLpmS-xAAWh8_pXBTA


xxxxxxxxxx
[
  {
    "current": {
      "battery": 90,
      "calcValue": [
        {
          "rateChange": 0,
          "value": 0,
          "variation": 0
        }
      ],
      "pointAlarmStatus": {
        "alarmState": 2,
        "occurTime": 1609638290190
      }
    },
    "interval": 28800,
    "metadata": {
      "deviceCode": "DZA19042538",
      "gps": {},
      "monitorTypeCode": "axisforceCab",
      "monitorTypeName": " 锚 索 轴 力 ",
      "nickname": " 锚 索  (2-1) ",
      "projectCode": "028",
      "projectName": "中电科科技创新园",
      "type": "DEV_ZXY"
    },
    "time": "20210106104536091",
    "uuid": "5947"
  },
  {
    "current": {
      "battery": 90,
      "calcValue": [
        {
          "rateChange": 0,
          "value": 1760.532,
          "variation": 0
        },
        {
          "rateChange": 0,
          "value": 3495.382,
          "variation": 0
        },
        {
          "rateChange": 0,
          "value": 5282.188,
          "variation": 0
        },
        {
          "rateChange": 0,
          "value": 7080.321,
          "variation": 0
        }
      ],
      "pointAlarmStatus": {
        "alarmState": 2,
        "occurTime": 1609901138013
      }
    },
    "interval": 28800,
    "metadata": {
      "deviceCode": "DZA19042538",
      "gps": {},
      "monitorTypeCode": "deepHorDis",
      "monitorTypeName": "深层水平位移 (测斜) ",
      "nickname": "CX-2",
      "projectCode": "028",
      "projectName": "中电科科技创新园",
      "type": "DEV_ZXY"
    },
    "time": "20210106104536091",
    "uuid": "5950"
  }
]

注: 以上数据不考虑逻辑关系


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 1,
    "result": null,
    "timestamp": "1686903200091"
}

4、映射表

类型	名称	单位
deepHorDis	深层水平位移 (测斜)	mm
froundLev	地下水位	mm
verSurface	周边地表竖向位移	mm
peripheralPip	周边管线沉降	mm
rainMon	雨量监测	mm
borderPro	临边防护	无
retainWallTopHorDis	围护墙 (边坡) 顶部水平位移	mm
retainWallTopVerDis	围护墙 (边坡) 顶部竖向位移	mm
columnsVerDis	立柱竖向位移	mm
soilLayersVerDis	土体分层竖向位移	mm
retainWallInner	围护墙 (桩 ) 内力	KN
InteEnvirMon	智能环境监测
steelSupportInner	钢支撑内力	KN
retainWallSoilLateralPre	围护墙侧向土压力	KN
rockBoltInner	锚杆 (索) 内力	KN
poreWaterPre	孔隙水压力	kPa
surBuildVerDis	周边建筑竖向位移	mm
surBuildiSlope	周边建筑倾斜	°
surBuildHorDis	周边建筑水平位移	mm
surBuildFissure	周边建筑裂缝	mm
standColumnTilt	立柱倾斜	°
propFracture	支撑裂缝	mm
soilNailInner	土钉内力	KN
interSupport	混凝土支撑内力	KN
standColumnInner	立柱内力	KN
conTemMea	混凝土测温	℃
interSupPile	支护桩内力	kn
lateralPress	侧向土压力	kn
layeredSoil	土体分层位移	mm
incliaMon	倾斜监测	°
settleFound	基坑周边沉降	mm
axisforceCab	锚索轴力	kn
axisforceSup	钢支撑轴力	kn
settleMon	沉降监测	mm
horizonDis	水平位移监测	mm
internalformon	内力监测	kn

联睿科-外墙脚手架监测数据推送标准_v1

1、推送方式

采用HTTP方式推送推送

推送地址 POST /xmgl/exteriorScaffoldingCurrentData/lrk/add
认证方式认证方式使用: ‘Bearer Token’(即在http的header添加Authorization) 如对接放无token 则不需要

2、数据格式

数据采用JSON格式封装, JSON字符使用UTF-8编码。
数据包含 必须字段 和 设备相关字段。
设备相关字段分 实时数据 和 静态数据 ，每次数据至少包含其一。
数据参考格式如下：


xxxxxxxxxx
[ { "uuid": "设备标识1", "time": "数据时间", "interval": "数据周期", "current": { 实时数据... }, "metadata": { 静态数据... } }, { "uuid": "设备标识2", "time": "数据时间", "interval": "数据周期", "current": { 实时数据... }, "metadata": { 静态数据...} } ]

2.1 、必须数据

参数名称	类型	必填	描述	限制
uuid	String	是	设备标识	同一项目唯一
time	String	是	数据采集时间, 格式YYYYMMddHHmmSSzzz	格式见下文说明
interval	Interger	是	数据采集周期, 即下次数据上传间隔	单位s

时间格式说明(时区UTC+8):

YYYY：日期年，如 2016 表示 2016 年;
MM：日期月，如 09 表示 9 月;
dd：日期日，如 23 表示 23 日;
HH：时间小时，24小时制。如 22 表示 22 点;
mm：时间分钟，如 05 表示 5 分;
SS：时间秒，如 59 表示 59 秒;
zzz：时间毫秒，如 500 表示 500 毫秒;

2.2、外墙脚手架监测设备相关字段

外墙脚手架监测数据模型版本: 1.0
注: 以’_’开头的字段表示子字段

2.2.1、实时数据

参数名称	类型	必填	名称	描述
battery	Float	否	电池电量	电量百分比(0-100)
calcValue	Object	否	计算值	单位根据监测类型

__value	Float	否	计算值	-
__variation	Float	否	变化值	-
__rateChange	Float	否	变化速率	-
alarmStatus	Integer	否	报警状态	0-正常；1-超报警；2-超控制；

2.2.2、静态数据

参数名称	类型	必填	名称	描述
org_name	String	否	厂商简称	监测设备厂商简称
nickname	String	否	测点昵称	-
deviceCode	String	否	设备编号	-
projectCode	String	否	项目编号	-
projectName	String	否	项目名称	-
monitorTypeCode	String	否	监测类型编号	详见深基坑的监测类型映射关系表
monitorTypeName	String	否	监测类型名称	-
type	String	否	设备类型	-
gps	Object	否	GPS位置	-
_lng	String	否	经度	-
_lat	String	否	纬度	-

3、数据示例

3.1、请求示例
POST /api/v1/events HTTP/1.1 Host: 127.0.0.1:8900 Content-Type: application/json Authorization: Bearer eyJhbGciOiJIUzI1NiIsImlhdCI66TUynTY1NjQ4MywiZXhwIjoxNTc3ODQyMDgzLjB9.eyJ2IjoiMSIsImkiaiJiMzFhY2U yNC01MTk1LTExZTgtOTJiNi0zNGY2NGI2NDkzMWMiLCJ0IjoiU3RhbmRhcmQiLCJqIjoic3RkMSIsInMiOjE1MjU2MjI0MDA uMCwiayI68ntcIm1cIbpcIkVudmlyb25tZW51CCJ9Nn0.nDdiDovoik9xcC_u2PmDdKpFIaLpmS-xAAWh8_pXBTA


xxxxxxxxxx
[
  {
    "uuid": "111111",
    "time": "20180101085857223",
    "interval": 10,
    "current": {
      "battery": 18961.9,
      "calcValue": [
        {
          "value": null,
          "variation": 42208.29,
          "rateChange": null
        }
      ],
      "alarmStatus": null
    },
    "metadata": {
      "org_name": null,
      "nickname": null,
      "deviceCode": "",
      "projectCode": null,
      "projectName": null,
      "monitorTypeCode": "incliaMon",
      "monitorTypeName": null,
      "type": null,
      "gps": {
        "lng": 2929.52,
        "lat": null
      }
    }
  },
  {
    "uuid": "222222",
    "time": "20180101085857225",
    "interval": 10,
    "current": {
      "battery": 18961.9,
      "calcValue": [
        {
          "value": null,
          "variation": 42208.29,
          "rateChange": null
        }
      ],
      "alarmStatus": null
    },
    "metadata": {
      "org_name": null,
      "nickname": null,
      "deviceCode": "",
      "projectCode": null,
      "projectName": null,
      "monitorTypeCode": "incliaMon",
      "monitorTypeName": null,
      "type": null,
      "gps": {
        "lng": 2929.52,
        "lat": null
      }
    }
  }
]

注: 以上数据不考虑逻辑关系

高支模自动化监测对接（联睿科）

设备上传的数据中如果包含工程的字段,则设备的数据可以按照设备自身的工程进行展示,

通讯协议:

服务器和传感器之间采取TCP/IP协议,通讯内容采用明码方式传送,传送的格式如下:

通讯方式如下:

规则：服务器每收到主机信息后需要回复指令给主机。

服务器回复指令：

非必须
序号	内容	标识	格式	备注
1	帧头	$LRKKJ$
2	文本消息	MSG	文本形式	非必传，
3	接收成功标志	OK	OK
4	结束位	END	END
例如：$LRKKJ$ MSG:”通知消息”; OK;END $LRKKJ$ MSG:”K0001_2018-08-17 170244”; OK;ENDMSG为非必传内容，用于服务器向测试主机发送相关的消息提醒。高支模主机收到该消息后，以小窗口模式显示服务器传输的消息内容。主机发出数据后，在10秒内没有收到服务器的回传确认消息，开始重新发送数据

主机开始采集时发送工程的信息，内容如下：

序号	内容	标识	格式
1	帧头	$LRKKJ$
2	设备类型	DEV_type	LKR_GZM
3	设备编号	DEV_BH	数组字母组合
4	定位信息	GPS_DEV_J，GPS_DEV_W	单位°，浮点数值
5	工程编号	TR_BH	字符串
6	上传编号	SC_BH	字符串
7	测点总数	CD_AL	数字
8	采样频率	JC_T	数字，单位秒
9	上传频率	SC_T	数字，单位秒
10	开始采集时间	TIME:	Yyyy-mm-dd hhmmss
11	帧尾	END

工程信息：

$LRKKJ$ DEV_type:LRK_GZM;DEV_BH:1;GPS_DEV_J:0;GPS_DEV_W:0;TR_BH:001;CD_AL:6;SC_BH:20200711;JC_T:2;SC_T:10;TIME:2020-07-11 144713;END

发送工程信息成功后发送每个测点的初始、报警、预警信息：

序号	内容	标识	格式	备注
1	帧头	$LRKKJ$
2	设备编号	DEV_BH	字符串
3	工程编号	TR_BH	字符串
4	终端编号	DEV_sn	字符串
5	测点编号	SN_CJ	字符串
6	测点初始值	GZ_CS
7	测点报警值	GZ_BJ
8	测点预警值	GZ_YJ
9	测点坐标	GZ_ZB	x,y	x,y坐标原点为工程图左上角位置,坐标为像素
10	帧尾	END
说明：测点编号后缀为测点类型识别：F-立杆轴力（单位为牛）、H-水平位移（单位为mm）、V-模板沉降（单位为mm）、L-立杆倾斜（单位为°）、D-地基沉降；,例如测点 0001L表示测点类型为立杆倾斜；

测点信息：

$LRKKJ$ DEV_BH:1;TR_BH:001;DEV_sn:0001;SN_CJ:0001RL;GZ_CS:0.000000;GZ_BJ:5.000000;GZ_YJ:1.000000;GZ_ZB:0,0;END

$LRKKJ$ DEV_BH:1;TR_BH:001;DEV_sn:0001;SN_CJ:00011#F;GZ_CS:0.000000;GZ_BJ:5.000000;GZ_YJ:1.000000;GZ_ZB:0,0;END

$LRKKJ$ DEV_BH:1;TR_BH:001;DEV_sn:0001;SN_CJ:00012#V;GZ_CS:0.000000;GZ_BJ:5.000000;GZ_YJ:1.000000;GZ_ZB:0,0;END

$LRKKJ$ DEV_BH:1;TR_BH:001;DEV_sn:0002;SN_CJ:0002RL;GZ_CS:0.000000;GZ_BJ:5.000000;GZ_YJ:1.000000;GZ_ZB:0,0;END

$LRKKJ$ DEV_BH:1;TR_BH:001;DEV_sn:0002;SN_CJ:00021#F;GZ_CS:0.000000;GZ_BJ:5.000000;GZ_YJ:1.000000;GZ_ZB:0,0;END

$LRKKJ$ DEV_BH:1;TR_BH:001;DEV_sn:0002;SN_CJ:00022#V;GZ_CS:0.000000;GZ_BJ:5.000000;GZ_YJ:1.000000;GZ_ZB:0,0;END

采集过程中，发送测点数据

序号	内容	标识	格式
1	帧头	$LRKKJ$
2	设备类型	DEV_type	LRK_GZM
3	设备编号	DEV_BH	字符串
4	终端编号	DEV_sn	字符串
5	工程编号	TR_BH	字符串
6	上传编号	SC_BH	字符串
7	测点编号1	GZ_CJ1	字符串
8	测点数据1	GZ_DS1
9	测点状态1	GZ_ZT1
10	测点编号2	GZ_CJ2
11	测点数据2	GZ_DS2
12	测点状态2	GZ_ZT2
13	测点编号3	GZ_CJ3
14	测点数据3	GZ_DS3
15	测点状态3	GZ_ZT3
16	采集时间	TIME	Yyyy-mm-dd hhmmss
17	帧尾	END
说明：测点状态、测点编号、测点数据为单测点实时数据状态；一次发送在采集的所有测点数据，状态表示 1表示正常 2表示离线 3表示报警 4表示预警

测点数据：

$LRKKJ$ DEV_type:LRK_GZM;DEV_BH:1;DEV_sn:0001;TR_BH:001;SC_BH:20200711;GZ_CJ1:0001RL;GZ_DS1:0.000000;GZ_ZT1:2;GZ_CJ2:00011#F;GZ_DS2:0.000000;GZ_ZT2:2;GZ_CJ3:00012#V;GZ_DS3:0.000000;GZ_ZT3:2;TIME:2020-07-11 144722;END

$LRKKJ$ DEV_type:LRK_GZM;DEV_BH:;DEV_sn:0002;TR_BH:001;SC_BH:20200711;GZ_CJ1:0002RL;GZ_DS1:0.000000;GZ_ZT1:2;GZ_CJ2:00021#F;GZ_DS2:0.000000;GZ_ZT2:2;GZ_CJ3:00022#V;GZ_DS3:0.000000;GZ_ZT3:2;TIME:2020-07-11 144722;END

$LRKKJ$ DEV_type:LRK_GZM;DEV_BH:;DEV_sn:0001;TR_BH:001;SC_BH:20200711;GZ_CJ1:0001RL;GZ_DS1:0.000000;GZ_ZT1:2;GZ_CJ2:00011#F;GZ_DS2:0.000000;GZ_ZT2:2;GZ_CJ3:00012#V;GZ_DS3:0.000000;GZ_ZT3:2;TIME:2020-07-11 144732;END

采集暂停、正常完成和异常结束

	设备头信息
序号	内容	标识	格式	备注
1	帧头	$LRKKJ$
2	设备类型	DEV_type	LRK_GZM
3	设备编号	DEV_BH	字符串
4	工程编号	TR_BH	字符串
5	上传编号	SC_BH	字符串
6	状态	GZ_GZT	1、2、3	1.正常完成；2.异常结束；3.暂停采样
7	结束时间	JS_T	Yyyy-mm-dd hhmmss
8	帧尾	END
示例：$LRKKJ$ DEV_type:LRK_GZM;DEV_BH:DS2020TEST;TR_BH:test;SC_BH:123;GZ_GZT:3;JS_T:2020-07-08142415;END

结束信息（以暂停监测为例）：

$LRKKJ$ DEV_type:LRK_GZM;DEV_BH:1;TR_BH:001;SC_BH:20200711;GZ_GZT:3;JS_T:2020-07-11144736;END

地磅对接

1.拉取过磅预约车辆数据列表

接口描述：	拉取过磅预约车辆数据列表
请求URL:	/xmgl/weight/weighBookVehicleInfo/pull/list
请求方式:	GET

请求参数：

参数名称	说明	是否必须	类型
beginTimestamp	开始时间	true	string
projectSn	所属项目SN	true	string

时间过滤条件是数据库每条记录的时间戳，不是应用报告的生成时间。
每次查询默认查出满足条件的前200条数据，如果第201条及之后的数据的时间戳与第200条相同，则一同查出，一次查询一般是200条数据
取下一页数据时需要将上一次请求返回的数据中的maxTimestamp的值给下一次请求链接中的beginTimestamp。
数据不包含开始时间但包含结束时间。

请求示例：/xmgl/weight/weighBookVehicleInfo/pull/list?beginTimestamp=2000-01-01 00:00:00&projectSn=xxx

响应参数：

参数名称	参数说明	类型
beginTimestamp	开始时间（格式：2016-08-09 10:01:54）	string
maxTimestamp	最大时间（格式：2016-08-09 10:01:54）	string
list	数据列表	WeighBookVehicleInfo实体类

WeighBookVehicleInfo实体类

参数名称	说明	类型
createTime	创建时间（格式：2016-08-09 10:01:54）	string
forwardingUnit	发货单位	string
goodsName	货名	string
id	主键id	long
licensePlate	车牌号码	string
projectSn	所属项目SN	string
receivingUnit	收货单位	string
reserve	备注	string
specifications	规格	string
updateTime	更新时间（格式：2016-08-09 10:01:54）	string
weighingType	过磅类型	integer
deleted	0正常1已删除	integer

响应示例：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": {
        "beginTimestamp": "2020-12-08 09:18:32",
        "maxTimestamp": "2023-08-02 09:45:49",
        "list": [
            {
                "id": "1680038492421480449",
                "licensePlate": "车牌号码",
                "forwardingUnit": "发货单位",
                "receivingUnit": "收货单位1",
                "goodsName": "货名",
                "specifications": "规格型号",
                "reserve": "备注",
                "weighingType": 1,
                "addDateTime": "2023-07-15 10:16:04",
                "createTime": "2023-07-15 10:16:04",
                "updateTime": "2023-07-15 10:59:41",
                "projectSn": "B717CB992D054A878FDAFB4A5C169947",
                "deleted": 0,
                "lastPullTime": null
            },
            {
                "id": "1686553859427880962",
                "licensePlate": "问",
                "forwardingUnit": "发货单位",
                "receivingUnit": "收货单位1",
                "goodsName": "货名",
                "specifications": "王企鹅",
                "reserve": "请问饿",
                "weighingType": 1,
                "addDateTime": "2023-08-02 09:45:49",
                "createTime": "2023-08-02 09:45:49",
                "updateTime": "2023-08-02 09:45:49",
                "projectSn": "B717CB992D054A878FDAFB4A5C169947",
                "deleted": 0,
                "lastPullTime": null
            }
        ]
    },
    "timestamp": "1702025127429"
}

2. 添加称重记录信息

接口描述：	添加称重记录信息
请求URL:	/xmgl/weight/weighInfo/add
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	说明	是否必须	类型
projectSn	所属项目SN	TRUE	string
licensePlate	车牌号码	TRUE	string
aCheckTime	一磅时间（格式：2023-04-18 20:56:29）	FALSE	string
bCheckTime	二磅时间（格式：2023-04-18 20:56:29）	FALSE	string
forwardingUnit	发货单位	FALSE	string
goodsName	货名	FALSE	string
grossTime	皮重时间（格式：2023-04-18 20:56:29）	FALSE	string
grossWeight	皮重	FALSE	float
netWeight	净重	FALSE	float
receivingUnit	收货单位	FALSE	string
removeWeighdataInfoId	远程id(自己的id)	FALSE	string
reserve	备注	FALSE	string
serialNo	流水号	FALSE	string
specifications	规格	FALSE	string
tare	毛重	FALSE	float
tareTime	毛重时间（格式：2023-04-18 20:56:29）	FALSE	string

请求示例：


xxxxxxxxxx
{
  "serialNo": "String",
  "licensePlate": "String",
  "forwardingUnit": "String",
  "receivingUnit": "String",
  "goodsName": "String",
  "specifications": "String",
  "reserve": "String",
  "tare": 0,
  "grossWeight": 0,
  "netWeight": 0,
  "grossTime": "2023-04-18 20:56:29",
  "tareTime": "2023-04-18 20:56:29",
  "aCheckTime": "2023-04-18 20:56:29",
  "bCheckTime": "2023-04-18 20:56:29",
  "projectSn": "String",
  "removeWeighdataInfoId": "String"
}

响应结果：

成功：


xxxxxxxxxx
{
  "success": true,
  "message": "操作成功！",
  "code": 200,
  "result": null,
  "timestamp": "1681814472197"
}

3. 添加称重图片信息

接口描述：	添加称重图片信息
请求URL:	/xmgl/weight/weighPic/add
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	说明	是否必须	类型
removeWeighdataInfoId	远程id(自己的id，即称重记录id)	TRUE	string
addDateTime	录入时间（格式：2023-04-18 20:56:29）	FALSE	string
emptyPic1	空车图片1	FALSE	string
emptyPic2	空车图片2	FALSE	string
emptyPic3	空车图片3	FALSE	string
emptyPic4	空车图片4	FALSE	string
fullPic1	重车图片1	FALSE	string
fullPic2	重车图片2	FALSE	string
fullPic3	重车图片3	FALSE	string
fullPic4	重车图片4	FALSE	string
modDateTime	修改时间（格式：2023-04-18 20:56:29）	FALSE	string
remarks	备注	FALSE	string

响应结果：

成功：


xxxxxxxxxx
{
  "success": true,
  "message": "操作成功！",
  "code": 200,
  "result": null,
  "timestamp": "1681814472197"
}

出入口车牌识别相机

所有识别的车辆信息都会上传到平台，但只有在平台白名单内的车辆会自动开闸，否则不会自动开闸

接口地址：

接入标准V1.0

采用HTTP协议传输数据

接口地址： /xmgl/carPassRecord/saveCarPassRecord

1 、对接流程

2、推送识别结果

2.1.1 推送例子


xxxxxxxxxx
POST <post_path> HTTP/1.1

Host: <post_server_ip>:<post_server_port>

Content-Type: application/x-www-form-urlencoded

Content-Length: <content_len>

type=online&mode=5&plate_num= 京 A12345&plate_color= 蓝 色 &plate_val=true&confidence=25&car_logo= 丰 田 &car_color= 白 色 &vehicle_type= 轿 车 &start_time=1436509947&park_id=2&cam_id=0001aa00000d&cam_ip=192.168.55.100&vdc_ty pe=in&is_whitelist=true&triger_type=video&picture=<BASE64 全景图 >&closeup_pic=<BASE64 车牌特写图>

2.1.2 推送内容字段说明

字段项	说明	备注
type	online 表示正常在线传输结果，offline 表示断网续传结果
mode	协议模式，数字表示
plate_num	车牌号码，UTF8 编码
plate_color	车牌底色，UTF8 编码
plate_val	虚假车牌信息，true 表示真牌，false 表示虚假车牌
confidence	置信度，范围：0-28
car_logo	车辆品牌，UTF8 编码
car_color	车辆颜色，UTF8 编码
vehicle_type	车辆类型，UTF8 编码
start_time	车牌识别时间,1970/01/01 到现在的秒数目
park_id	车场 ID（取项目sn），最大支持 60 个字符	只支持英文、数字
cam_id	相机 ID
cam_ip	相机 IP
vdc_type	出入口类型，in 表示入口，out 表示出口
picture	全景图，BASE64 编码	为避免 Http 传输时 URL 编码意外
		改变图片的 BASE64 编码，作了
		特殊的替换：'+'替换为'-'，'/'替
		换为'_'，'='替换为'.'
closeup_pic	车牌特写图，BASE64 编码	为避免 Http 传输时 URL 编码意外
		改变图片的 BASE64 编码，作了
		特殊的替换：'+'替换为'-'，'/'替
		换为'_'，'='替换为'.'

3 、推送心跳

推送例子


xxxxxxxxxx
POST <post_path> HTTP/1.1
Host: <post_server_ip>:<post_server_port>
Content-Type: application/x-www-form-urlencoded
Content-Length: <content_len>
type=heartbeat&mode=5&interval=10&park_id=2&cam_id=0001aa00000d&cam_ip=192.168.55. 100

推送内容字段说明

字段项	说明	备注
type	heartbeat 表示是心跳
mode	协议模式，数字表示
interval	心跳间隔，单位秒
park_id	车场 ID，最大支持 60 个字符	只支持英文、数字
cam_id	相机 ID	相机 ID 号根据配置决定是使用MAC 还是 UID
cam_ip	相机 IP

4、 Http 服务器应答

注：心跳也会应答，当应答中有指令下发时，也需执行相关操作

应答数据内容例子

注意：下面例子为了文档说明特意把 JSON 格式化展开，实际应答时是不带换行的普通 JSON 内容。


xxxxxxxxxx
{
  "error_num": 0,
  "error_str": "error info",
  "passwd": "xxxxxxx",
  "gpio_data": [
    {
      "ionum": "io1",
      "action": "on"
    }
  ]
}

应答内容字段说明

字段项	类型	必填项	说明
error_num	int	是	错误码，0 表示无错误，其它表示有错误
error_str	string	是	错误码说明
gpio_data		否	开闸 GPIO 数据
ionum	string	否	输出 IO 口，"io1"固定开闸用
action	string	否	输出动作，"on"为开闸

5、现场硬件对接

服务器地址、接口、路径需要填：http://ip:端口/xmgl/carPassRecord/saveCarPassRecord

UID需要填车场id（就是项目sn）

标养室对接

标养室上传实时数据

接口描述：	标养室上传实时数据
请求URL:	/xmgl/standardCurrentData/addCurrentData
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	说明	参数类型	是否必须	类型
arefaction	除湿,1开，2关	body	false	int32
auxiliaryHeat	辅热,1开，2关	body	false	int32
devSn	标养室唯一标识	body	false	string
fan	风机,1开，2关	body	false	int32
humidification	加湿,1开，2关	body	false	int32
humidity	湿度	body	false	string
runState	运行状态，1运行，2停止	body	false	int32
temperature	温度	body	false	string
temperatureControl	控温,1开，2关	body	false	int32

请求体实例：


xxxxxxxxxx
{
  "arefaction": 0,
  "auxiliaryHeat": 0,
  "devSn": "916256CDD7FE49DAB6A36474A98A3D16",
  "fan": 0,
  "humidification": 0,
  "humidity": "101",
  "runState": 0,
  "temperature": "51",
  "temperatureControl": 0
}

响应示例：

1.成功：


xxxxxxxxxx
{
  "success": true,
  "message": "操作成功！",
  "code": 200,
  "result": null,
  "timestamp": "1681814472197"
}

2：失败


xxxxxxxxxx
{
  "success": false,
  "message": "设备编号不正确",
  "code": 5000,
  "result": null,
  "timestamp": "1681539012624"
}

AI识别对接

报警信息上报

接口描述：	报警信息上报
请求URL:	/xmgl/api/saveHardWareAlarm
请求方式:	POST
Content-Type：	application/json

请求参数：

参数	是否比传	说明
hardwareId	true	硬件id
datetime	true	时间yyyy-MM-dd HH-mm-ss
image	true	图片 base64
type	true	类型 1-烟感报警、2-明火报警、3-人员倒地报警、4-未带安全帽报警、5-区域入侵报警、6-越界入侵报警、7-人员聚集报警、8-未穿反光衣或工作服、9-裸土覆盖、10-口罩识别、11-徘徊预警、12-物体滞留监测、13-绊线监测
location	true	位置

请求示例：


xxxxxxxxxx
{
  "hardwareId": "1122",
  "datetime": "2023-04-17 00:00:00",
  "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABgAAD//gAUU29mdHdhcmU6IFNuaXBhc3Rl/9sAQwADAgIDAgIDAwMDBAMDBAUIBQUEBAUKBwcGCAwKDAwLCgsLDQ4SEA0OEQ4LCxAWEBETFBUVFQwPFxgWFBgSFBUU/9sAQwEDBAQFBAUJBQUJFA0LDRQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQU/8AAEQgAAQABAwEiAAIRAQMRAf/EAB8AAAEFAQEBAQEBAAAAAAAAAAABAgMEBQYHCAkKC//EALUQAAIBAwMCBAMFBQQEAAABfQECAwAEEQUSITFBBhNRYQcicRQygZGhCCNCscEVUtHwJDNicoIJChYXGBkaJSYnKCkqNDU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6g4SFhoeIiYqSk5SVlpeYmZqio6Slpqeoqaqys7S1tre4ubrCw8TFxsfIycrS09TV1tfY2drh4uPk5ebn6Onq8fLz9PX29/j5+v/EAB8BAAMBAQEBAQEBAQEAAAAAAAABAgMEBQYHCAkKC//EALURAAIBAgQEAwQHBQQEAAECdwABAgMRBAUhMQYSQVEHYXETIjKBCBRCkaGxwQkjM1LwFWJy0QoWJDThJfEXGBkaJicoKSo1Njc4OTpDREVGR0hJSlNUVVZXWFlaY2RlZmdoaWpzdHV2d3h5eoKDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uLj5OXm5+jp6vLz9PX29/j5+v/aAAwDAQACEQMRAD8AZRRRX9Zn8GH/2Q==",
  "type": 1,
  "location": "大门"
}

返回结果


xxxxxxxxxx
{
  "success": true,
  "message": "操作成功！",
  "code": 200,
  "result": null,
  "timestamp": "1681814472197"
}

TCK.W钢丝绳

上传钢丝绳检测结果记录

接口描述：	上传钢丝绳检测结果记录
请求URL:	/xmgl/tckw/tckwWireRopeInspectionRecord/addWithDamage
请求方式:	POST
Content-Type：	application/json

注：TCK.W钢丝绳检测系统，随着钢丝绳的运动，每完成一次检测，主动推送检测结果数据。

请求参数：


xxxxxxxxxx
｛
 “ID” : <整型>,               释义：TCK.W检测站点唯一ID号
 “name” : <字符串>,            释义：TCK.W检测站点名称
 “start_time” : <字符串>,      释义：检测开始时间，格式：2023-05-22 18:00:00
 “end_time” : <字符串>,        释义：检测结束时间，格式：2023-05-22 18:00:00
 “start_pos” : <浮点数>,       释义：检测起始位置，单位：m
 “end_pos” : <浮点数>,     释义：检测结束位置，单位：m
 “avg_speed” : <浮点数>,       释义：平均速度，单位：m/s
 “flaw_cnt” : <整型>,         释义：损伤数量
 “flaw_list” : <数组>,            释义：损伤列表
[
 [
      <整型>,             释义：钢丝绳号（单绳总为1，多绳按1、2、3、4 … 区分）
      <浮点数>,                释义：损伤位置，单位：m
      <浮点数>,                释义：损伤起始位置，单位：m
      <浮点数>,                释义：损伤结束位置，单位：m
      <浮点数>,                释义：损伤量值（有效金属截面积损失率），单位：%
      <整型>,             释义：损伤程度（0=轻微，1=轻度，2=中度，3=较重，4=严重，5=超限）
 ],
 . . . . . .
],
 “rope_dm” : <浮点数>,     释义：钢丝绳直径，单位：mm
 “rope_spec” : <字符串>,       释义：钢丝绳规格型号
 “rope_len” : <浮点数>,        释义：钢丝绳长度，单位：m
 “rope_cnt” : <整型>,     释义：钢丝绳根数
｝

请求示例：


xxxxxxxxxx
{
  "ID": 102,
  "name": "站点名称",
  "start_time": "2023-05-22 18:00:00",
  "end_time": "2023-05-22 19:00:00",
  "start_pos": 1.1,
  "end_pos": 1.2,
  "avg_speed": 1.1,
  "flaw_cnt": 1,
  "flaw_list": [
    [
      1,
      1.1,
      1.1,
      1.2,
      1.1,
      2
    ]
  ],
  "rope_dm": 1.1,
  "rope_spec": "钢丝绳规格型号",
  "rope_len": 2,
  "rope_cnt": 10
}

响应结果：

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1677809789150"
}

龙门吊对接

1、添加龙门吊实时数据

接口描述：	添加龙门吊实时数据
请求URL:	/xmgl/gantryCraneApi/saveGantrycraneRealtimeData
请求方式:	POST
Content-Type：	application/json

请求参数：

字段	类型	说明	是否必传
devSn	String	设备识别码(平台生成的唯一识别码)	是
runTime	String	运行时间，时间格式如2021-03-08 09:23:08	是
windSpeed	float	风速（m/s）	是
windSpeedState	char	风速状态 0: 正常1:预警2:报警	是
angleXAxis	float	X轴实时倾角(°)	是
angleYAxis	float	Y轴实时倾角(°)	是
angleXState	char	X轴倾斜状态 0: 正常1:预警2:报警	否
angleYState	char	Y轴倾斜状态 0: 正常1:预警2:报警	否
largeCraneRange	float	大车行程（m）	是
largeCraneSpeed	float	大车速度（m/s）	是
smallCraneRange	float	小车1行程（m）	是
smallCraneSpeed	float	小车1速度（m/s）	是
secondSmallCraneRange	float	小车2行程（m）	否
secondSmallCraneSpeed	float	小车2速度（m/s）	否
smallCraneMainHookLoad	float	小车1主钩吊重（t）	是
smallCraneMainHookHeight	float	小车1主钩高度（m）	是
smallCraneAuxiliaryHookLoad	float	小车1副钩吊重（t）	是
smallCraneAuxiliaryHookHeight	float	小车1副钩高度（m）	是
secondSmallCraneMainHookLoad	float	小车2主钩吊重（t）	否
secondSmallCraneMainHookHeight	float	小车2主钩高度（m）	否
secondSmallCraneAuxiliaryHookLoad	float	小车2副钩吊重（t）	否
secondSmallCraneAuxiliaryHookHeight	float	小车2副钩高度（m）	否
mainHookCurrent	float	小车1主钩电流	否
mainHookVoltage	float	小车1主钩电压	否
secondMainHookCurrent	float	小车2主钩电流	否
secondMainHookVoltage	float	小车2主钩电压	否
largeCraneDistanceState	char	大车行程状态 0: 正常1: 左限预警2: 右限预警3: 左限控制4: 右限控制	是
smallCraneRangeState	char	小车1幅度状态 0: 正常,1: 左限位,2: 右限位	是
secondSmallCraneRangeState	char	小车2幅度状态 0: 正常,1: 左限位,2: 右限位	否
mainHookWeightState	char	小车1主钩载重状态 0: 正常，1: 空载，2: 轻载，3: 重载，4: 满载，5: 超载，6: 控制	是
secondMainHookWeightState	char	小车2主钩载重状态 0: 正常，1: 空载，2: 轻载，3: 重载，4: 满载，5: 超载，6: 控制	否
auxiliaryHookWeightState	char	小车1副钩载重状态 0: 正常，1: 空载，2: 轻载，3: 重载，4: 满载，5: 超载，6: 控制	是
secondAuxiliaryHookWeightState	char	小车2副钩载重状态 0: 正常，1: 空载，2: 轻载，3: 重载，4: 满载，5: 超载，6: 控制	否
mainHookHeightState	char	小车1主钩高度状态 0: 正常，1: 上限位	是
secondMainHookHeightState	char	小车2主钩高度状态 0: 正常，1: 上限位	否
auxiliaryHookHeightState	char	小车1副钩高度状态 0: 正常，1: 上限位	是
secondAuxiliaryHookHeightState	char	小车2副钩高度状态 0: 正常，1: 上限位	否
gatedState	char	门控状态 0:关闭 1:打开	是
antiWindAndNonslipState	char	抗风防滑状态 0:未锚定 1:锚定成功	是
cableReelStatus	char	电缆卷筒状态 0:正常 1:报警	是
largeCarSafeStatus	char	大车防碰撞状态 0:正常 1:左侧防撞报警 2:右侧防撞报警	否
largeCarRunStatus	char	大车运行状态 0:停止 1:左移 2:右移3:故障	是
smallCarRunStatus	char	小车1运行状态 0:停止 1:前进 2:后退 3:故障	是
secondSmallCarRunStatus	char	小车2运行状态 0:停止 1:前进 2:后退 3:故障	否
masterHookRunStatus	char	小车1主钩运行状态 0:停止 1:上升 2:下降 3:故障	是
secondMasterHookRunStatus	char	小车2主钩运行状态 0:停止 1:上升 2:下降 3:故障	否
subHookRunStatus	char	小车1副钩运行状态 0:停止 1:上升 2:下降 3:故障	是
secondSubHookRunStatus	char	小车2副钩运行状态 0:停止 1:上升 2:下降 3:故障	否
driverName	String	操作员姓名	否
driverIdCard	String	操作员身份证号	否
totalDay	String	累计工作天数(天)	否
totalTimes	String	累计工作时分秒 HH:MM:SS	否
powerOnDay	String	当前工作天数 (天)	是
powerOnTimes	String	当前工作时分秒 HH:MM:SS	是

请求示例：


xxxxxxxxxx
{
  "devSn": "A2740F41305C419F8BFE9D50E365AB53",
  "runTime": "2023-08-01 09:23:08",
  "windSpeed": 20,
  "windSpeedState": 2,
  "angleYAxis": 26,
  "angleXAxis": 30,
  "angleXState": 1,
  "angleYState": 2,
  "largeCraneRange": 100,
  "smallCraneSpeed": 10,
  "largeCraneSpeed": 12,
  "smallCraneRange": 60,
  "secondSmallCraneRange": 80,
  "secondSmallCraneMainHookLoad": 400,
   "secondSmallCraneMainHookHeight": 12,
   "smallCraneMainHookLoad":500,
   "smallCraneMainHookHeight":5

}

响应结果：

失败：


xxxxxxxxxx
{
  "success": false,
  "message": "Incorrect equipment number",
  "code": 5000,
  "result": null,
  "timestamp": 1617264186112
}

成功：


xxxxxxxxxx
{
  "success": true,
  "message": "Operation succeeded！",
  "code": 200,
  "result": null,
  "timestamp": 1617264342406
}

2、添加龙门吊报警数据

接口描述：	添加龙门吊报警数据
请求URL:	xmgl/gantryCraneApi/addGantryCraneAlarm
请求方式:	POST
Content-Type：	application/json

请求参数：

字段	类型	说明	是否必传
devSn	String	设备识别码(平台生成的唯一识别码)	是
startTime	String	开始时间，时间格式如2021-03-08 09:23:08	是
endTime	String	结束时间,时间格式如2021-03-08 09:23:08	是
driverName	String	司机姓名	否
driverIdCard	String	司机身份证号	否
certification	String	特种作业号	否
masterHookWeightAlarm	char	小车1主钩载重状态 0: 正常1: 报警	是
subHookWeightAlarm	char	小车1副钩载重状态 0: 正常1: 报警	是
secondMasterHookWeightAlarm	char	小车2主钩载重状态 0: 正常1: 报警	否
secondSubHookWeightAlarm	char	小车2副钩载重状态 0: 正常1: 报警	否
largeCarRangePreAlarm	char	大车行程状态 0: 正常1: 报警	是
smallCarRangePreAlarm	char	小车1行程状态 0: 正常1: 报警	是
secondSmallCarRangePreAlarm	char	小车2行程状态 0: 正常1: 报警	是
windSpeedAlarm	char	风速状态 0: 正常1: 报警	是
dipXAlarm	char	倾角X状态 0: 正常1: 报警	是
dipYAlarm	char	倾角Y状态 0: 正常1: 报警	是
doorCtrlStatus	char	门控状态 0: 正常1: 报警	是
noSlipStatus	char	抗风防滑状态 0: 正常1: 报警	是
cableReelStatus	char	电缆卷筒状态 0: 正常1: 报警	是
largeCarSafeStatus	char	大车防碰撞状态 0:正常 1:左侧防撞报警 2:右侧防撞报警	否

请求示例：


xxxxxxxxxx
{
    "devSn": "A2740F41305C419F8BFE9D50E365AB53",
    "startTime": "2023-08-15 09:23:08",
    "endTime": "2023-08-15 09:24:08",
    "masterHookWeightAlarm": 0,
    "subHookWeightAlarm": 1,
    "secondMasterHookWeightAlarm": 0,
    "secondSubHookWeightAlarm": 1,
    "largeCarRangePreAlarm": 1,
    "smallCarRangePreAlarm": 0,
    "driverName": "张三",
    "driverIdCard": "520181200203204612",
    "secondSmallCarRangePreAlarm": 1,
    "windSpeedAlarm": 10,
    "dipXAlarm": 0,
    "dipYAlarm": 0,
    "noSlipStatus": 0,
    "cableReelStatus": 1,
    "largeCarSafeStatus": 2
}

3、添加龙门吊循环数据

接口描述：	添加龙门吊循环数据
请求URL:	/xmgl/gantryCraneApi/addGantryCraneWorkCycle
请求方式:	POST
Content-Type：	application/json

请求参数：

字段	类型	说明	是否必传
devSn	String	设备识别码(平台生成的唯一识别码)	是
startTime	String	工作循环开始时间，时间格式如2021-03-08 09:23:08	是
endTime	String	工作循环结束时间,时间格式如2021-03-08 09:23:08	是
workTime	int	工作循环持续时长单位（s）	是
driverName	String	司机姓名	否
driverIdCard	String	司机身份证号	否
masterHookWorkStartHeight	float	小车1主钩开始高度（m）	是
masterHookWorkEndHeight	float	小车1主钩结束高度（m）	是
masterHookWorkMaxWeight	float	小车1主钩最大载重（t）	是
masterHookWorkOperation	char	小车1主钩操作指令 0:停止 1:上升 2:下降	是
subHookWorkStartHeight	float	小车1副钩开始高度（m）	是
subHookWorkEndHeight	float	小车1副钩结束高度（m）	是
subHookWorkMaxWeight	float	小车1副钩最大载重（t）	是
subHookWorkOperation	char	小车1副钩操作指令 0:停止 1:上升 2:下降	是
secondMasterHookWorkStartHeight	float	小车2主钩开始高度（m）（t）	否
secondMasterHookWorkEndHeight	float	小车2主钩结束高度（m）	否
secondMasterHookWorkMaxWeight	float	小车2主钩最大载重（t）	否
secondMasterHookWorkOperation	char	小车2主钩操作指令 0:停止 1:上升 2:下降	否
secondSubHookWorkStartHeight	float	小车2副钩开始高度（m）	否
secondSubHookWorkEndHeight	float	小车2副钩结束高度（m）	否
secondSubHookWorkMaxWeight	float	小车2副钩最大载重（t）	否
secondSubHookWorkOperation	char	小车2副钩操作指令 0:停止 1:上升 2:下降	否
largeCarWorkStartRange	float	大车开始行程（m）	是
largeCarWorkEndRange	float	大车结束行程（m）	是
largeCarWorkMaxSpeed	float	大车最大速度（m/s）	是
largeCarWorkOperation	char	大车操作指令 0:停止 1:左移 2:右移	是
smallCarWorkStartRange	float	小车1开始行程（m）	是
smallCarWorkEndRange	float	小车1结束行程（m）	是
smallCarWorkMaxSpeed	float	小车1最大速度（m/s）	是
smallCarWorkOperation	char	小车1操作指令 0:停止 1:左移 2:右移	是
secondSmallCarWorkStartRange	float	小车2开始行程（m）	否
secondSmallCarWorkEndRange	float	小车2结束行程（m）	否
secondSmallCarWorkMaxSpeed	float	小车2最大速度（m/s）	否
secondSmallCarWorkOperation	char	小车2操作指令 0:停止 1:左移 2:右移	否
workType	char	吊重循环类型 0:主钩 1:副钩	否
maxDipX	float	X轴最大倾角	是
maxDipY	float	Y轴最大倾角	是
maxWindSpeed	float	最大风速(m/s)	是
masterHookWorkAlarm	char	小车1主钩报警状态 0:正常 1:预警 2:报警	是
subHookWorkAlarm	char	小车1副钩报警状态 0:正常 1:预警 2:报警	是
secondMasterHookWorkAlarm	char	小车2主钩报警状态 0:正常 1:预警 2:报警	否
secondSubHookWorkAlarm	char	小车2副钩报警状态 0:正常 1:预警 2:报警	是
largeCarSpeedWorkAlarm	char	大车速度报警状态 0:正常 1:预警 2:报警	是
smallCarSpeedWorkAlarm	char	小车1速度报警状态 0:正常 1:预警 2:报警	是
secondSmallCarSpeedWorkAlarm	char	小车2速度报警状态 0:正常 1:预警 2:报警	否
dipXWorkAlarm	char	倾角X报警状态 0:正常 1:预警 2:报警	是
dipYWorkAlarm	char	倾角Y报警状态 0:正常 1:预警 2:报警	是
windSpeedWorkAlarm	char	风速报警状态 0:正常 1:预警 2:报警	是
workSafeStatus	String	防碰撞报警状态 0:正常 1:左侧防撞报警 2:右侧防撞报警	否

4、修改龙门吊设备信息

接口描述：	修改龙门吊设备信息
请求URL:	/xmgl/gantryCraneApi/updateDev
请求方式:	POST
Content-Type：	application/json

请求参数：

字段	类型	说明	是否必传
devSn	String	设备识别码(平台生成的唯一识别码)	是
mainHangerRatedLoad	float	小车1主钩额定载重（t）	是
auxiliaryHangerRatedLoad	float	小车1副钩额定载重（t）	是
masterHookMaximumHeight	float	小车1主钩最大高度（m）	是
subHookMaximumHeight	float	小车1副钩最大高度（m）	是
masterHookMinimumHeight	float	小车1主钩最小高度（m）	是
subHookMinimumHeight	float	小车1副钩最小高度（m）	是
secondMainHangerRatedLoad	float	小车2主钩额定载重（t）	否
secondAuxiliaryHangerRatedLoad	float	小车2副钩额定载重（t）	否
secondMasterHookMaximumHeight	float	小车2主钩最大高度（m）	否
secondSubHookMaximumHeight	float	小车2副钩最大高度（m）	否
secondMasterHookMinimumHeight	float	小车2主钩最小高度（m）	否
secondSubHookMinimumHeight	float	小车2副钩最小高度（m）	否
largeCarMaximumRange	float	大车最大行程（m）	是
largeCarMinimumRange	float	大车最小行程（m）	是
smallCarMaximumRange	float	小车1最大行程（m）	是
smallCarMinimumRange	float	小车1最小行程（m）	是
secondSmallCarMaximumRange	float	小车2最大行程（m）	否
secondSmallCarMinimumRange	float	小车2最小行程（m）	否
largeCarRatedSpeed	float	大车额定速度	是
smallCarRatedSpeed	float	小车1额定速度	是
secondSmallCarRatedSpeed	float	小车2额定速度	否
ratedObliguityX	float	额定X轴倾角	是
ratedObliguityY	float	额定Y轴倾角	否
ratedWindSpeed	float	额定风速	否
latitude	String	纬度	否
longitude	String	经度	否

卸料平台对接

1、添加卸料平台实时数据和报警信息

接口描述：	添加卸料平台实时数据和报警信息
请求URL:	/xmgl/dischargingPlatformCurrentData/add
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	说明	参数类型	是否必须	类型
devSn	设备编号	body	true	string
isAlarm	是否有报警，0否，1是	body	false	int32
alarmLevel	报警等级，1 紧急告警，2 重要告警，3 次要告警，4 提示告警	body	false	int32
alarmType	报警类型	body	false	string
displacement	位移，单位米	body	false	string
loading	载重，单位吨	body	false	string
reciveTime	接收创建时间	body	false	string
xdipAngle	X倾角	body	false	string
ydipAngle	Y倾角	body	false	string

请求示例：


xxxxxxxxxx
{
    "alarmLevel": 1,
    "alarmType": "",
    "devSn": "ED6AEEFCFFA5472CA56476706AF3FC6F",
    "displacement": "123",
    "isAlarm": 0,
    "loading": "100",
    "reciveTime": "2023-06-14 19:12:00",
    "xdipAngle": "1",
    "ydipAngle": "2"
}

响应结果：

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1677809789150"
}

车辆冲洗对接

1、添加车辆冲洗实时数据

接口描述：	添加车辆冲洗实时数据
请求URL:	/xmgl/carWashCurrentData/add
请求方式:	POST
Content-Type：	application/json

请求参数：

字段	说明	是否必传
deviceNo	设备编号(平台生成的唯一识别码)	是
captureTime	抓拍时间，时间格式如2021-03-08 09:23:08	是
carNumber	车牌号	是
carColour	车身颜色	否
leaveTime	车辆离开时间	是
photoUrl	告警照片文件地址Url	是
vedioUrl	告警声音文件地址Url	否
alarmType	告警类型,1：车辆绕行,2：冲洗时间不足,3：未冲洗,4：其他,5：正常冲洗	是
leaveVedioUrl	离开工地视频地址 Url	是
vehicleType	车型	否

响应结果：

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1677809789150"
}

大体积混凝土监测对接

1、添加混凝土监测实时数据

接口描述：	添加混凝土监测实时数据
请求URL:	/xmgl/concreteMonitorCurrentData/add
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	说明	参数类型	是否必须	类型	schema
devSn	设备编号	body	true	string
list	监测点数据	body	true	array	ConcreteMonitorCurrentData实体类

ConcreteMonitorCurrentData实体类

参数名称	说明	参数类型	是否必须	类型
pointNo	监测点点位号（在平台新增设备时，指定的监测点的序号（从1开始））	body	false	int32
receiveTime	接收时间，格式：2021-05-11 14:00:00	body	false	string
temperature	温度	body	false	double

请求示例：


xxxxxxxxxx
{
    "devSn": "325235",
    "list": [
        {
            "pointNo": 1,
            "receiveTime": "2023-06-14 14:00:00",
            "temperature": 10
        }
    ]
}

响应结果：

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1677809789150"
}

2、添加混凝土监测-报警数据

接口描述：	添加混凝土监测-报警数据
请求URL:	/xmgl/concreteMonitorAlarm/add
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	说明	参数类型	是否必须	类型
addTime	混凝土监测警时间	body	true	date-time
alarmLevel	报警等级，1 紧急告警，2 重要告警，3 次要告警，4 提示告警	body	false	int32
alarmType	报警类型	body	false	string
alarmValue	报警值	body	false	double
devSn	设备编号	body	false	string
pointNo	监测点点位号	body	false	int32

请求示例：


xxxxxxxxxx
{
  "devSn": "999",
  "pointNo": 1,
  "alarmType": "报警类型",
  "addTime": "2023-08-01 11:08:57",
  "alarmValue": 89.00,
  "alarmLevel": 1
}

响应结果：

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1677809789150"
}

有毒气体对接

1、上报有毒气体数据和报警数据（安帕尔）

2、上报有毒气体数据和报警数据

接口描述：	上报有毒气体数据和报警数据
请求URL:	/xmgl/poisonousGasDevCurrentData/add
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	参数说明	请求类型	是否必须	数据类型
devSn	设备sn	body	true	string
gasType	气体类型（1氧气、2甲烷、3一氧化碳）	body	true	integer(int32)
gasVal	气体值	body	true	number(double)
unit	单位 0:ppm;1:%LEL;2:%VOL;3:mg/m3;4:pphm;5:g/m3;6:无单位;7:ppb	body	true	integer(int32)
uploadTime	上传时间 yyyy-MM-dd HH:mm:ss	body	true	string(date-time)
alarmType	报警状态 0正常1低报警2高报警3超量程	body	true	integer(int32)

请求示例：


xxxxxxxxxx
{
    "devSn": "07241801",
    "gasType": 1,
    "gasVal": 0,
    "unit": 1,
    "uploadTime": "2023-08-12 13:00:00",
    "alarmType": 0
}

响应结果：

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1677809789150"
}

烟感报警对接

1、添加烟感报警数据信息（艾礼安）

接口描述：	添加烟感报警数据信息（艾礼安）
请求URL:	/xmgl/smokeDevAlarm/addAlarm
请求方式:	POST
Content-Type：	application/json

请求参数：

参数	类型	位置	描述
deviceid	String	body	设备ID
devicename	String	body	设备名称
type	String	body	设备类型（跟随客户端中的产品型号）
address	String	body	安装位置
person	string	body	联系人
tel	string	body	联系电话
alarm	int	body	0报警恢复；1表示报警； 2表示心跳
state	String	body	状态，内容：布防、撤防、SOS、盗警、交流电故障等
zone	String	body	防区编号
zonename	String	body	防区内容
time	String	body	时间戳（具体到毫秒）
number	String	body	事件序号（00-FF）
code	String	body	系统标识

请求示例：


xxxxxxxxxx
{
  "deviceid": "7",
  "devicename": "",
  "type": "",
  "address": "",
  "person": "",
  "tel": "",
  "alarm": 1,
  "state": "布防",
  "zone": "",
  "zonename": "",
  "time": "1691141851598",
  "number": "",
  "code": ""
}

响应 0：表示成功 1：表示失败

人员定位对接

1、上传人员定位实时数据

接口描述：	上传人员定位实时数据
请求URL:	/xmgl/positionRealData/addPositionRealData
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	参数说明	请求类型	是否必须	数据类型
deviceId	卡片编号	body	true	string
projectSn	项目sn	body	true	string
loraRssi	卡片信号强度	body	true	int
battery	卡片电量	body	true	string
dianya	卡片电压	body	true	string
beacons	数据列表	body	true	Array

beacons 说明：

参数名称	参数说明	请求类型	是否必须	数据类型
major	信标major	body	true	string
minor	信标minor	body	true	string
rssi	信标信号强度	body	true	int

请求示例：


xxxxxxxxxx
{
    "beacons": [
        {
            "major": "信标major",
            "minor": "信标minor",
            "rssi": 123
        }
    ],
    "deviceId": "1",
    "projectSn": "9586E48795D1437C819DB1FEFE0F4777",
    "loraRssi": 12,
    "battery": "100",
    "dianya": "16"
}

响应成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1694575442336"
}

隧道定位（吉联达）

1.上传隧道全量人员定位实时数据

URl	/api/uploadLocationDataList
请求方式	POST

参数列表：

参数	类型	说明
projectId	string	项目ID
personId	string	人员ID 唯一
cardType	string	标签类型，1510人员，1520车辆
cardno	string	标签号
personName	string	人员姓名
companyId	string	企业ID
companyName	string	班组企业名称
teamId	string	班组ID
teamName	string	班组名称
department	string	部门名称
gender	string	性别
phone	string	电话号码
idNumber	string	身份证号码
deviceSn	string	设备SN
deviceName	string	设备名称
regionId	string	区域ID
regionCode	string	区域Code（可自定义）
regionName	string	区域名称
pileNo	string	标签实际位置(桩号)
nX	float	标签实际位置（米）
nY	float	标签相对地图Y位置(米)
pX	float	标签X位置(单位像素) 相对12000*12000位置坐标
pY	float	标签Y位置（单位像素）
inlX	float	标签距离洞口（米）
masterX	float	标签距离基站米数
ringNum	float	标签位置环数（地铁项目单位）
longitude	String	经度需正确填写坐标映射表
latitude	string	纬度需正确填写坐标映射表
altitude	string	高程
alarm	int	报警类型 0正常，1求救报警，4静止报警，8低电量报警
volume	int	标签电量 0-100%
heartRate	string	心率 0-240 0未正常检测或检测超时
updateTime	datetime	更新时间

示例数据：


xxxxxxxxxx
{
    "count": 2,
    "data": "W3siYWxhcm0iOjAsImNhcmRUeXBlIjoxNTEwLCJjYXJkbm8iOiIxNzUzMiIsImNvbXBhbnlJZCI6IuWQieiBlOi+vuWKs+WKoeaciemZkOWFrOWPuCIsImNvbXBhbnlOYW1lIjoi5ZCJ6IGU6L6+5Yqz5Yqh5pyJ6ZmQ5YWs5Y+4IiwiZGVwYXJ0bWVudCI6Ium7mOiupOmDqOmXqCIsImRlcHRJZCI6IjcwMzI0MjYzMzc5MDAxIiwiZGV2aWNlTmFtZSI6IumrmOeyvuW6puWumuS9jeiuvuWkhyg1NTU1KSIsImRldmljZVNuIjoiNTU1NSIsImdlbmRlciI6IueUtyIsImhlYXJ0UmF0ZSI6MjU1LCJpZE51bWJlciI6IiIsImlubFgiOjEwOC41NzQ0NzA1MjAwMTk1MywibGF0IjoiOS43OCIsImxvbmciOiI5Ljc4IiwibWFzdGVyWCI6OS43Nzk5OTk3MzI5NzExOTEsIm5YIjoxMDguNTc0NDcwNTIwMDE5NTMsIm5ZIjo1LjY5OTk5OTgwOTI2NTEzNywib3hpbWV0ZXIiOjI1NSwicFgiOjEwOC41NzQ0NzA1MjAwMTk1MywicFkiOjUuNjk5OTk5ODA5MjY1MTM3LCJwZXJzb25JZCI6IjIwMTYzNDA1MDQwMjA4IiwicGVyc29uTmFtZSI6Ik4xNzUzMiIsInBob25lIjoiIiwicGlsZU5vIjoiWkswMDArMDA5Ljc4IiwicHJvamVjdElkIjoiNTAxMjYwNDE4NjM2MDEiLCJyZWdpb25JZCI6IjMwMzQxMTE2NjkwMzAyIiwicmVnaW9uTmFtZSI6IuW3pua0nuWMuuWfnyIsInJpbmdOdW0iOiI2MC4zIiwic3RheVRpbWUiOiIwIiwidGVhbUlkIjoiODAyMTIwODUwMDE5MDIiLCJ0ZWFtTmFtZSI6IueuoeeQhuS6uuWRmCIsInVwZGF0ZVRpbWUiOiIyMDIzLTAzLTE4IDIzOjQ4OjIxIiwidm9sdW1lIjo1OH0seyJhbGFybSI6MCwiY2FyZFR5cGUiOjE1MTAsImNhcmRubyI6IjQzMDM5IiwiY29tcGFueUlkIjoi5ZCJ6IGU6L6+5Yqz5Yqh5pyJ6ZmQ5YWs5Y+4IiwiY29tcGFueU5hbWUiOiLlkInogZTovr7lirPliqHmnInpmZDlhazlj7giLCJkZXBhcnRtZW50Ijoi6buY6K6k6YOo6ZeoIiwiZGVwdElkIjoiNzAzMjQyNjMzNzkwMDEiLCJkZXZpY2VOYW1lIjoi6auY57K+5bqm5a6a5L2N6K6+5aSHKDU1NTUpIiwiZGV2aWNlU24iOiI1NTU1IiwiZ2VuZGVyIjoi55S3IiwiaGVhcnRSYXRlIjoyNTUsImlkTnVtYmVyIjoiTlRFeU5USTNNVGsyTXpBeU1EZzBNRFU1IiwiaW5sWCI6MTA4LjY3MTk1ODkyMzMzOTg0LCJsYXQiOiI5Ljg2IiwibG9uZyI6IjkuODYiLCJtYXN0ZXJYIjo5Ljg1OTk5OTY1NjY3NzI0NiwiblgiOjEwOC42NzE5NTg5MjMzMzk4NCwiblkiOjUuNjk5OTk5ODA5MjY1MTM3LCJveGltZXRlciI6MjU1LCJwWCI6MTA4LjY3MTk1ODkyMzMzOTg0LCJwWSI6NS42OTk5OTk4MDkyNjUxMzcsInBlcnNvbklkIjoiMjAxNjM0MDUwNDAyMDUiLCJwZXJzb25OYW1lIjoi5buW5rC457qiIiwicGhvbmUiOiIiLCJwaWxlTm8iOiJaSzAwMCswMDkuODYiLCJwcm9qZWN0SWQiOiI1MDEyNjA0MTg2MzYwMSIsInJlZ2lvbklkIjoiMzAzNDExMTY2OTAzMDIiLCJyZWdpb25OYW1lIjoi5bem5rSe5Yy65Z+fIiwicmluZ051bSI6IjYwLjQiLCJzdGF5VGltZSI6IjAiLCJ0ZWFtSWQiOiI4MDIxMjA4NTAwMTkwOCIsInRlYW1OYW1lIjoi5LqM6KGs54+t57uEIiwidXBkYXRlVGltZSI6IjIwMjMtMDMtMTggMjM6NDg6MjIiLCJ2b2x1bWUiOjc5fV0=",
    "projectGroup": "50126041863601"
}

返回参数：

参数	类型	说明
code	int	状态代码，200为成功，其他为失败。必要返回
data	string	返回说明

返回值示例：


xxxxxxxxxx
{
    "data": "add ok!",
    "code": 200,
    "info": "success"
}

a) POST请求参数放在body里

b) ContentType：application/json

c) data数据部分需进行base64解密。

2.低电量报警

URl	/api/uploadTagLowVoltageAlarm
请求方式	POST

参数列表：

参数	类型	说明
projectId	string	项目ID
alarmType	string	报警类型 = 2140
alarmId	string	报警编号
personId	string	工号
cardno	string	标签卡号
personName	string	姓名
idNumber	string	身份证号码
phone	string	联系电话
teamId	string	班组ID
teamName	string	班组名称
voltage	Int	当前电量百分比
updateTime	datetime	报警时间

示例数据：


xxxxxxxxxx
{
    "count": 1,
    "data": "W3siYWxhcm1JZCI6MzExMzQ3NDA2OTkwMDEsImFsYXJtVHlwZSI6MjQ3MCwiY2FyZG5vIjoiMTAxMTgiLCJpZE51bWJlciI6Ik5URXhOVEl4TVRrNE5EQTNNREkyTVRNMCIsInBlcnNvbklkIjoiMjAxNjM0MDUwNDAyMTEiLCJwZXJzb25OYW1lIjoiTjEwMTE4IiwicGhvbmUiOiIiLCJwcm9qZWN0SWQiOiI1MDEyNjA0MTg2MzYwMSIsInRlYW1JZCI6IjgwMjEyMDg1MDAxOTE0IiwidGVhbU5hbWUiOiLoo4Xovb3mnLrnj63nu4QiLCJ1cGRhdGVUaW1lIjoiMjAyMy0wMy0xOSAyMzoxODozMyIsInZvbHRhZ2UiOjI3fV0=",
    "projectGroup": "50126041863601"
}

返回参数：

参数	类型	说明
code	int	状态代码，200为成功，其他为失败。必要返回
data	string	返回说明

返回值示例：


xxxxxxxxxx
{
    "data": "add ok!",
    "code": 200,
    "info": "success"
}

a) POST请求参数放在body里

b) ContentType：application/json

c) data数据部分需进行base64解密。

车辆（人员）定位对接

1、添加车辆（人员）定位-实时数据信息

接口描述：	添加车辆（人员）定位-实时数据信息
请求URL:	/xmgl/vehiclePositionData/add
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	参数说明	请求类型	是否必须	数据类型
devSn	设备序号	body	true	string
longitude	当前位置-经度	body	true	number(double)
latitude	当前位置-维度	body	true	number(double)
batteryPercentage	电量百分比	body	false	number(double)
cumulativeOperatingFuelConsumptionDay	当日累计作业油耗(L)	body	false	number(double)
totalFuelConsumptionDay	当日累计油耗(L)	body	false	number(double)
totalSleepTimeDay	当日累计休眠时长(H)	body	false	number(double)
totalWorkTimeDay	当日累计作业时长(H)	body	false	number(double)
speed	时速	body	false	number(double)

请求示例：


xxxxxxxxxx
{
    "devSn": "159874",
    "latitude": 10.1,
    "longitude": 10.2,
    "batteryPercentage": 0,
    "cumulativeOperatingFuelConsumptionDay": 0,
    "totalFuelConsumptionDay": 0,
    "totalSleepTimeDay": 0,
    "totalWorkTimeDay": 0,
    "speed": 15
}

响应示例：

失败：


xxxxxxxxxx
{
    "success": false,
    "message": "设备不存在",
    "code": 5000,
    "result": null,
    "timestamp": "1700704267775"
}

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1677809789150"
}

2、添加车辆（人员）定位-报警记录信息

接口描述：	添加车辆（人员）定位-报警记录信息
请求URL:	/xmgl/vehiclePositionAlarm/add
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	参数说明	请求类型	是否必须	数据类型
alarmInformation	报警信息	body	true	string
devSn	设备序号	body	true	string

请求示例：


xxxxxxxxxx
{
    "alarmInformation": "自定义报警消息内容",
    "devSn": "159874"
}

响应示例：

失败：


xxxxxxxxxx
{
    "success": false,
    "message": "设备不存在",
    "code": 5000,
    "result": null,
    "timestamp": "1700704267775"
}

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1677809789150"
}

3、添加车辆（人员）定位-日行数据

接口描述：	添加车辆（人员）定位-日行数据
请求URL:	/xmgl/vehiclePositionDayRecord/add
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	参数说明	请求类型	是否必须	数据类型
day	日期（格式：yyyy-MM-dd）	body	true	string
devSn	设备序号	body	true	string
trackDistanceDay	每日轨迹距离	body	true	number(double)

请求示例：


xxxxxxxxxx
{
    "day": "2023-11-23",
    "devSn": "159874",
    "trackDistanceDay": 12.23
}

响应示例：

失败：


xxxxxxxxxx
{
    "success": false,
    "message": "设备不存在",
    "code": 5000,
    "result": null,
    "timestamp": "1700704267775"
}

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1677809789150"
}

智能张拉和压浆对接

1、添加智能张拉-数据信息

接口描述：	添加智能张拉-数据信息
请求URL:	/xmgl/smartTensionData/add
请求方式:	POST
Content-Type：	application/json

请求参数：

SmartTensionData实体类

参数名称	参数说明	请求类型	是否必须	数据类型
devSn	设备编码	body	true	string
anchorSheetThickness	锚片厚度	body	false	string
beamType	梁型	body	false	string
beamNumber	梁号	body	false	string
concreteDesignStrength	砼设计强度	body	false	string
constructionPart	施工部位	body	false	string
equipmentManufacturer	设备厂家	body	false	string
status	状态:1合格2不合格3未判定	body	false	integer(int32)
tensionTime	张拉时间（格式：yyyy-MM-dd HH:mm:ss）	body	false	string
beamDataList	智能张拉-钢束数据列表（SmartTensionSteelBeamData类）	body	false	array

SmartTensionSteelBeamData实体类

参数名称	参数说明	请求类型	是否必须	数据类型
designTension	设计张拉力(kN)	body	false	number(double)
elongationError	伸长量误差(%)	body	false	number(double)
holdingTime	持荷时间(s)	body	false	number(double)
retractionAmount	回缩量(mm)	body	false	number(double)
section	断面	body	false	integer(int32)
status	状态:1合格2不合格3未判定	body	false	integer(int32)
tendonNumber	钢束编号	body	false	string
tensionError	张拉力误差(%)	body	false	number(double)
tensionTime	张拉时间（格式：yyyy-MM-dd HH:mm:ss）	body	false	string
theoreticalElongation	理论伸长量(mm)	body	false	number(double)
totalElongation	总伸长量(mm)	body	false	number(double)
curveDataList	曲线数据集合（CurveData类）	body	false	array
tripProgressList	行程进度集合（TripProgress类）	body	false	array

CurveData类

参数名称	参数说明	请求类型	是否必须	数据类型
xAxis	x轴的值	body	false	string
yOilPressure	y轴油压的值	body	false	string
yElongation	y轴伸长量的值	body	false	string
yTension	y轴张拉力的值	body	false	string

TripProgress类

参数名称	参数说明	请求类型	是否必须	数据类型
progressName	行程进度名称	body	false	string
elongation	伸长量的值	body	false	number(double)
oilPressure	油压的值	body	false	number(double)
tension	张拉力的值	body	false	number(double)

请求示例：


xxxxxxxxxx
{
    "devSn": "22",
    "anchorSheetThickness": "",
    "beamDataList": [
        {
            "curveDataList": [
                {
                    "xAxis": "2023-11-28 17:42:17",
                    "yElongation": 32.0,
                    "yOilPressure": 12.0,
                    "yTension": 23.0
                },
                {
                    "xAxis": "2023-11-28 17:43:17",
                    "yElongation": 35.0,
                    "yOilPressure": 13.0,
                    "yTension": 43.0
                }
            ],
            "designTension": 0,
            "elongationError": 0,
            "holdingTime": 0,
            "retractionAmount": 0,
            "section": 0,
            "status": 1,
            "tendonNumber": "",
            "tensionError": 0,
            "tensionTime": "2023-10-18 11:23:50",
            "theoreticalElongation": 0,
            "totalElongation": 0,
            "tripProgressList": [
                {
                    "elongation": 23.0,
                    "oilPressure": 32.0,
                    "progressName": "10%",
                    "tension": 12.0
                },
                {
                    "elongation": 43.0,
                    "oilPressure": 35.0,
                    "progressName": "20%",
                    "tension": 13.0
                }
            ]
        }
    ],
    "beamType": "",
    "beamNumber": "",
    "concreteDesignStrength": "",
    "constructionPart": "",
    "equipmentManufacturer": "",
    "status": 1,
    "tensionTime": "2023-10-18 11:23:50"
}

响应示例：

失败：


xxxxxxxxxx
{
  "success": false,
  "message": "设备编号不正确", 
  "code": 5000,
  "result": null,
  "timestamp": "1677809107994"
}

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1677809789150"
}

2、添加智能压浆-数据信息

接口描述：	添加智能压浆-数据信息
请求URL:	/xmgl/smartGroutData/add
请求方式:	POST
Content-Type：	application/json

请求参数：

SmartGroutData实体类

参数名称	参数说明	请求类型	是否必须	数据类型
devSn	设备编码	body	true	string
beamNumber	梁号	body	false	string
beamType	梁型	body	false	string
concreteDesignStrength	砼设计强度	body	false	string
constructionPart	施工部位	body	false	string
equipmentManufacturer	设备厂家	body	false	string
status	状态:1合格2不合格3未判定	body	false	integer(int32)
tensionGroutTime	压浆时间（格式：yyyy-MM-dd HH:mm:ss）	body	false	string
beamDataList	智能压浆-钢束数据列表（SmartGroutSteelBeamData实体类）	body	false	array

SmartGroutSteelBeamData实体类

参数名称	参数说明	请求类型	是否必须	数据类型
dischargeGroutPressure	出浆压力(Mpa)	body	false	number(double)
tendonNumber	钢束编号	body	false	string
startTime	开始时间（格式：yyyy-MM-dd HH:mm:ss）	body	false	string
endTime	结束时间（格式：yyyy-MM-dd HH:mm:ss）	body	false	string
feedGroutPressure	进浆压力(Mpa)	body	false	number(double)
groutDirection	压浆方向	body	false	string
groutSequence	压浆顺序	body	false	string
inputGroutAmount	进浆量(L)	body	false	number(double)
mixRatio	配合比(水泥:添加剂:水)	body	false	string
mixTime	搅拌时间(s)	body	false	number(double)
status	状态:1合格2不合格3未判定	body	false	integer(int32)
theoreticalGroutAmount	理论浆量(L)	body	false	number(double)
waterBinderRatio	水胶比	body	false	number(double)
groutCurveList	压浆曲线列表（GroutCurve类）	body	false	array

GroutCurve

参数名称	参数说明	请求类型	是否必须	数据类型
dischargeGrout	出浆压力的值	body	false	number(double)
inputGrout	进浆压力的值	body	false	number(double)
inputGroutAmount	进浆量的值	body	false	number(double)
xAxis	x轴的值	body	false	string

请求示例：


xxxxxxxxxx
{
    "devSn": "1",
    "beamNumber": "",
    "beamType": "",
    "concreteDesignStrength": "",
    "constructionPart": "",
    "equipmentManufacturer": "",
    "status": 1,
    "tensionGroutTime": "2023-10-18 11:23:50",
    "beamDataList": [
        {
            "dischargeGroutPressure": 0,
            "endTime": "2023-10-18 11:23:50",
            "feedGroutPressure": 0,
            "groutCurveList": [
                {
                    "dischargeGrout": 23.0,
                    "inputGrout": 12.0,
                    "inputGroutAmount": 32.0,
                    "xAxis": "2023-11-28 17:42:17"
                },
                {
                    "dischargeGrout": 43.0,
                    "inputGrout": 13.0,
                    "inputGroutAmount": 35.0,
                    "xAxis": "2023-11-28 17:43:18"
                }
            ],
            "groutDirection": "",
            "groutSequence": "",
            "inputGroutAmount": 0,
            "mixRatio": "",
            "mixTime": 0,
            "smartGroutDataId": 0,
            "startTime": "2023-10-18 11:23:50",
            "status": 1,
            "tendonNumber": "",
            "theoreticalGroutAmount": 0,
            "waterBinderRatio": 0
        }
    ]
}

响应示例：

失败：


xxxxxxxxxx
{
  "success": false,
  "message": "设备编号不正确", 
  "code": 5000,
  "result": null,
  "timestamp": "1677809107994"
}

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1677809789150"
}

水稳拌合站对接

1、添加水稳拌合站数据信息

接口描述：	添加水稳拌合站数据信息
请求URL:	/xmgl/stableWaterMixStationData/add
请求方式:	POST
Content-Type：	application/json

请求参数：

StableWaterMixStationData实体类

参数名称	参数说明	请求类型	是否必须	数据类型
devSn	设备sn	body	true	string
bwsfid	部位三方id	body	false	string
clbm	材料编码	body	false	string
cldsfid	材料第三方ID	body	false	string
clggxh	材料规格型号	body	false	string
clmc	材料名称	body	false	string
cph	车牌号	body	false	string
czy	操作员	body	false	string
gcmc	工程名称	body	false	string
glzdlj	骨粒最大粒径	body	false	string
jldw	计量单位	body	false	string
jzbh	机组编号	body	false	string
kddj	抗冻等级	body	false	string
ksdj	抗渗等级	body	false	string
kzdj	抗折等级	body	false	string
pbbh	配比编号,	body	false	string
qddj	强度等级	body	false	string
rwbh	任务编号	body	false	string
scbz	删除标识 Y已删除，N未删除	body	false	string
scsj	生产时间 / 发料时间（格式：yyyy-MM-dd HH:mm:ss.SSS）	body	false	string
scsl	生产数量	body	false	integer(int32)
sj	司机	body	false	string
sldw	收料单位	body	false	string
source	单据来源	body	false	string
sybw	使用部位	body	false	string
tbbm	同步编码	body	false	string
timestamp	时间戳（格式：yyyy-MM-dd HH:mm:ss.SSS）	body	false	string
tld	塌落度	body	false	string
setDataList	水稳拌合站盘次数据列表（StableWaterMixStationSetData实体类）	body	false	array

StableWaterMixStationSetData实体类

参数名称	参数说明	请求类型	是否必须	数据类型
jbsc	搅拌时长	body	false	integer(int32)
jssj	结束时间（格式：yyyy-MM-dd HH:mm:ss）	body	false	string
kssj	开始时间（格式：yyyy-MM-dd HH:mm:ss）	body	false	string
pc	盘次	body	false	integer(int32)
sl	数量	body	false	integer(int32)
rawMaterialDataList	水稳拌合站原材数据列表（StableWaterMixStationRawMaterialData实体类）	body	false	array

StableWaterMixStationRawMaterialData实体类

参数名称	参数说明	请求类型	是否必须	数据类型
bzhl	标准耗量	body	false	number(double)
clbm	材料编码	body	false	string
cldsfid	材料第三方ID	body	false	string
clggxh	材料规格型号	body	false	string
clmc	材料名	body	false	string
jldw	计量单位	body	false	string
jzyc	机组原材	body	false	string
sjhl	实际耗量	body	false	number(double)

请求示例：


xxxxxxxxxx
{
    "devSn": "1",
    "bwsfid": "",
    "clbm": "",
    "cldsfid": "",
    "clggxh": "",
    "clmc": "",
    "cph": "",
    "czy": "",
    "gcmc": "",
    "glzdlj": "",
    "jldw": "",
    "jzbh": "",
    "kddj": "",
    "ksdj": "",
    "kzdj": "",
    "pbbh": "",
    "qddj": "",
    "rwbh": "",
    "scbz": "",
    "scsj": "2023-12-01 17:53:12.321",
    "scsl": 1,
    "sj": "",
    "sldw": "",
    "source": "",
    "sybw": "",
    "tbbm": "",
    "timestamp": "2023-12-01 17:53:12.123",
    "tld": "",
    "setDataList": [
        {
            "jbsc": 12,
            "jssj": "2023-12-01 17:53:12",
            "kssj": "2023-12-01 17:53:12",
            "pc": 1,
            "sl": 1,
            "rawMaterialDataList": [
                {
                    "bzhl": 1,
                    "clbm": "",
                    "cldsfid": "",
                    "clggxh": "",
                    "clmc": "",
                    "jldw": "",
                    "jzyc": "",
                    "sjhl": 1
                }
            ]
        }
    ]
}

响应示例：

失败：


xxxxxxxxxx
{
  "success": false,
  "message": "设备编号不正确",
  "code": 5000,
  "result": null,
  "timestamp": "1677809107994"
}

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1677809789150"
}

挂篮检测对接

1、添加挂篮检测（凯德尔）-数据信息

接口描述：	添加挂篮检测（凯德尔）-数据信息
请求URL:	/xmgl/hangBasketDetectKdeData/add
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	参数说明	请求类型	是否必须	数据类型
devSn	设备编码	body	true	string
data1	风速(m/s)	body	false	number(double)
data10	主桁架应力测点4(Mpa)	body	false	number(double)
data11	吊带应力测点1(Mpa)	body	false	number(double)
data12	吊带应力测点2(Mpa)	body	false	number(double)
data13	预埋应力测点1(Mpa)	body	false	number(double)
data14	预埋应力测点2(Mpa)	body	false	number(double)
data15	备用应力测点1(Mpa)	body	false	number(double)
data16	备用应力测点2(Mpa)	body	false	number(double)
data17	备用应力测点3(Mpa)	body	false	number(double)
data18	主桁架水平测点1(度)	body	false	number(double)
data19	主桁架水平测点2(度)	body	false	number(double)
data2	风级()	body	false	number(double)
data20	主桁架水平测点3(度)	body	false	number(double)
data21	主桁架水平测点4(度)	body	false	number(double)
data22	底部水平测点(度)	body	false	number(double)
data23	钢结构许用应力(Mpa)	body	false	number(double)
data24	混凝土许用应力(Mpa)	body	false	number(double)
data25	主桁架水平度阈值(度)	body	false	number(double)
data26	风速阈值(m/s)	body	false	number(double)
data27	后锚应力测点温度1(度)	body	false	number(double)
data28	后锚应力测点温度2(度)	body	false	number(double)
data29	传感器报警状态(Bit位编码，顺序见编号对照一览表。对应位为0表示正常，为1报警；)	body	false	integer(int32)
data3	正负零激光测点1(米)	body	false	number(double)
data30	备用()	body	false	string
data31	备用()	body	false	string
data32	主桁架应力测点温度1(度)	body	false	number(double)
data33	主桁架应力测点温度2(度)	body	false	number(double)
data34	主桁架应力测点温度3(度)	body	false	number(double)
data35	主桁架应力测点温度4(度)	body	false	number(double)
data36	吊带应力测点温度1(度)	body	false	number(double)
data37	吊带应力测点温度2(度)	body	false	number(double)
data38	预埋应力测点温度1(度)	body	false	number(double)
data39	预埋应力测点温度2(度)	body	false	number(double)
data4	正负零激光测点2(米)	body	false	number(double)
data40	传感器是否正常(18路传感器状态。Bit0至bit17分别代表1到18路传感器状态。为0表示正常，为1表示传感器异常。编码顺序和报警的状态顺序一致。)	body	false	integer(int32)
data5	后锚应力测点1(Mpa)	body	false	number(double)
data6	后锚应力测点2(Mpa)	body	false	number(double)
data7	主桁架应力测点1(Mpa)	body	false	number(double)
data8	主桁架应力测点2(Mpa)	body	false	number(double)
data9	主桁架应力测点3(Mpa)	body	false	number(double)
time	时间(yyyy-MM-dd HH:mm:ss)	body	false	string(date-time)

请求示例：


xxxxxxxxxx
{

        "devSn": "1",
        "data1": 0,
        "data10": 0,
        "data11": 0,
        "data12": 0,
        "data13": 0,
        "data14": 0,
        "data15": 0,
        "data16": 0,
        "data17": 0,
        "data18": 0,
        "data19": 0,
        "data2": 0,
        "data20": 0,
        "data21": 0,
        "data22": 0,
        "data23": 0,
        "data24": 0,
        "data25": 0,
        "data26": 0,
        "data27": 0,
        "data28": 0,
        "data29": 0,
        "data3": 0,
        "data30": "",
        "data31": "",
        "data32": 0,
        "data33": 0,
        "data34": 0,
        "data35": 0,
        "data36": 0,
        "data37": 0,
        "data38": 0,
        "data39": 0,
        "data4": 0,
        "data40": 0,
        "data5": 0,
        "data6": 0,
        "data7": 0,
        "data8": 0,
        "data9": 0,
        "time": "2023-12-04 17:40:55"
    }

响应示例：

失败：


xxxxxxxxxx
{
  "success": false,
  "message": "设备编号不正确",
  "code": 5000,
  "result": null,
  "timestamp": "1677809107994"
}

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1677809789150"
}

污水监测对接

1、添加污水数据信息

接口描述：	添加污水数据信息
请求URL:	/xmgl/sewageData/add
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	参数说明	请求类型	是否必须	数据类型
devSn	设备sn	body	true	string
conductivity	电导率（μS/cm）	body	false	number(double)
dissolvedOxygen	溶解氧（mg/L）	body	false	number(double)
flowVelocity	流速（m/s）	body	false	number(double)
phValue	PH值	body	false	number(double)
turbidityValue	浊度值（NTU）	body	false	number(double)
waterLevel	水位（m）	body	false	number(double)
waterTemperature	水温（℃）	body	false	number(double)

请求示例：


xxxxxxxxxx
{
    "devSn": "2",
    "conductivity": 1,
    "dissolvedOxygen": 0,
    "flowVelocity": 0,
    "phValue": 0,
    "turbidityValue": 0,
    "waterLevel": 0,
    "waterTemperature": 0
}

响应示例：

失败：


xxxxxxxxxx
{
  "success": false,
  "message": "设备编号不正确",
  "code": 5000,
  "result": null,
  "timestamp": "1677809107994"
}

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1677809789150"
}

仓库工器具设备对接

1、更新仓库工器具设备状态

接口描述：	更新仓库工器具设备状态
请求URL:	/xmgl/rtTool/updateRtToolStatus
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	说明	参数类型	是否必须	类型
devSn	设备编号	body	true	string
toolStatus	工器具状态：1在场2离场	body	true	int

请求示例：


xxxxxxxxxx
{
    "devSn": "12311213",
    "toolStatus": 2
}

响应示例：

失败：


xxxxxxxxxx
{
  "success": false,
  "message": "设备编号不正确",
  "code": 5000,
  "result": null,
  "timestamp": "1677809107994"
}

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1703469856184"
}

喷淋设备对接(榕图)

1、列表查询喷淋-设备信息(榕图)

接口描述：	列表查询喷淋-设备信息
请求URL:	xmgl/sprayRtDev/list
请求方式:	GET

请求参数：

参数名称	说明	参数类型	是否必须	类型
devSn	设备编码	query	false	string

响应参数：

参数名称	说明	类型
id	主键id	string
devSn	设备编码	string
devName	设备名称	string
switchStatus	开关状态，1关，2开	int
projectSn	项目编码	string
createDate	创建时间	string
updateDate	修改时间	string

请求示例：


xxxxxxxxxx
xmgl/sprayRtDev/list?devSn=1

响应示例：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": [
        {
            "id": "1",
            "devSn": "1",
            "devName": "设备名称",
            "switchStatus": 1,
            "projectSn": "B717CB992D054A878FDAFB4A5C169947",
            "createDate": "2017-12-03 15:14:29",
            "updateDate": "2024-01-24 11:30:08"
        }
    ],
    "timestamp": "1706067010130"
}

2、修改查询喷淋-设备信息(榕图)

接口描述：	通过devSn修改查询喷淋-设备信息
请求URL:	/xmgl/sprayRtDev/editByDevSn
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	说明	类型	是否必须
devSn	设备编码	string	true
switchStatus	开关状态，1关，2开	int	true

请求示例：


xxxxxxxxxx
{
    "devSn": "333",
    "switchStatus": 1
}

响应示例：

失败：


xxxxxxxxxx
{
    "success": false,
    "message": "设备sn不存在",
    "code": 5000,
    "result": null,
    "timestamp": "1706067626239"
}

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1677809789150"
}

3、上传喷淋-数据信息(榕图)

接口描述：	上传喷淋-数据信息(榕图)
请求URL:	xmgl/sprayRtData/add
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	说明	类型	是否必须
devSn	设备编码	string	true
beginTime	开始时间(格式：yyyy-MM-dd HH:mm:ss)	string	true
endTime	结束时间(格式：yyyy-MM-dd HH:mm:ss)	string	true

请求示例：


xxxxxxxxxx
{
    "devSn": "1",
    "beginTime": "2024-01-24 11:44:54",
    "endTime": "2024-01-24 11:44:55"
}

响应示例：

失败：


xxxxxxxxxx
{
    "success": false,
    "message": "设备sn不存在",
    "code": 5000,
    "result": null,
    "timestamp": "1706067626239"
}

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1677809789150"
}

架桥机对接

1、添加架桥机生产数据信息

接口描述：	添加架桥机生产数据信息
请求URL:	/xmgl/bridgeErectMachineData/add
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	参数说明	请求类型	是否必须	数据类型
devSn	设备编码	body	true	string
auxiliaryHookHeight	副钩高度(m)	body	false	number(double)
auxiliaryHookLiftingWeight	副钩吊重(t)	body	false	number(double)
auxiliaryHookSpeed	副钩速度(m/min)	body	false	number(double)
bigCarTrip	大车行程(m)	body	false	number(double)
bigCartSpeed	大车速度(m/min)	body	false	number(double)
carSpeed	小车速度(m/min)	body	false	number(double)
carTrip	小车行程(m)	body	false	number(double)
mainHookHeight	主钩高度(m)	body	false	number(double)
mainHookLiftingWeight	主钩吊重(t)	body	false	number(double)
mainHookSpeed	主钩速度(m/min)	body	false	number(double)
windSpeed	风速(m/s)	body	false	number(double)

请求示例：


xxxxxxxxxx
{
  "devSn": "1",
  "windSpeed": 0.00,
  "mainHookLiftingWeight": 0.00,
  "mainHookHeight": 0.00,
  "mainHookSpeed": 0.00,
  "auxiliaryHookLiftingWeight": 0.00,
  "auxiliaryHookHeight": 0.00,
  "auxiliaryHookSpeed": 0.00,
  "bigCarTrip": 0.00,
  "bigCartSpeed": 0.00,
  "carTrip": 0.00,
  "carSpeed": 0.00
}

响应示例：

失败：


xxxxxxxxxx
{
  "success": false,
  "message": "设备编号不正确",
  "code": 5000,
  "result": null,
  "timestamp": "1677809107994"
}

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1677809789150"
}

2、添加架桥机报警数据

接口描述：	添加架桥机报警数据
请求URL:	xmgl/bridgeErectMachineAlarm/add
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	参数说明	请求类型	是否必须	数据类型
devSn	设备编号	body	true	string
addTime	架桥机报警时间	body	false	string(date-time)
certification	特种作业号	body	false	string
driverIdCard	司机身份证号	body	false	string
driverName	司机姓名	body	false	string
startTime	开始时间	body	false	string
endTime	结束时间	body	false	string
largeCarRangePreAlarm	大车行程状态 0: 正常1: 报警	body	false	integer(int32)
largeCarSpeedAlarm	大车速度状态 0: 正常1: 报警	body	false	integer(int32)
masterHookWeightAlarm	主钩吊重状态 0: 正常1: 报警	body	false	integer(int32)
secondMasterHookWeightAlarm	小车2主钩吊重状态 0: 正常1: 报警	body	false	integer(int32)
secondSmallCarRangePreAlarm	小车2行程状态 0: 正常1: 报警	body	false	integer(int32)
secondSubHookWeightAlarm	小车2副钩吊重状态 0: 正常1: 报警	body	false	integer(int32)
smallCarRangePreAlarm	小车(天车)行程状态 0: 正常1: 报警	body	false	integer(int32)
smallCarSpeedAlarm	小车速度状态 0: 正常1: 报警	body	false	integer(int32)
subHookWeightAlarm	副钩吊重状态 0: 正常1: 报警	body	false	integer(int32)
windSpeedAlarm	风速状态 0: 正常1: 报警	body	false	integer(int32)

请求示例：


xxxxxxxxxx
{
  "devSn": "1",
  "startTime": "",
  "endTime": "",
  "addTime": "2024-01-31 14:26:05",
  "driverName": "",
  "driverIdCard": "",
  "certification": "",
  "masterHookWeightAlarm": 0,
  "subHookWeightAlarm": 0,
  "secondMasterHookWeightAlarm": 0,
  "secondSubHookWeightAlarm": 0,
  "largeCarRangePreAlarm": 0,
  "smallCarRangePreAlarm": 0,
  "secondSmallCarRangePreAlarm": 0,
  "largeCarSpeedAlarm": 0,
  "smallCarSpeedAlarm": 0,
  "windSpeedAlarm": 0
}

挂篮监测对接

1、添加挂篮监测数据信息

接口描述：	添加挂篮监测数据信息
请求URL:	/xmgl/hangBasketDetectData/add
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	参数说明	请求类型	是否必须	数据类型
devSn	设备编码	body	true	string
bottomFilmHeightDifference	底膜高度差(mm)	body	false	number(double)
bottomFilmHeightLeft	底膜高度左(mm)	body	false	number(double)
bottomFilmHeightRight	底膜高度右(mm)	body	false	number(double)
hangingBasketSomeone	挂篮有人：1有人2无人	body	false	integer(int32)
inclination	倾角	body	false	number(double)
leftRearBeamAnchor	左后梁锚杆(kN)	body	false	number(double)
rearBeamFixedAnchor1	后梁固定锚杆1#，状态：1正常2未连接3未使用4报警	body	false	integer(int32)
rearBeamFixedAnchor2	后梁固定锚杆2#，状态：1正常2未连接3未使用4报警	body	false	integer(int32)
rearBeamFixedAnchor3	后梁固定锚杆3#，状态：1正常2未连接3未使用4报警	body	false	integer(int32)
rearBeamFixedAnchor4	后梁固定锚杆4#，状态：1正常2未连接3未使用4报警	body	false	integer(int32)
rearBeamFixedAnchor5	后梁固定锚杆5#，状态：1正常2未连接3未使用4报警	body	false	integer(int32)
rearBeamFixedAnchor6	后梁固定锚杆6#，状态：1正常2未连接3未使用4报警	body	false	integer(int32)
rearBeamFixedAnchor7	后梁固定锚杆7#，状态：1正常2未连接3未使用4报警	body	false	integer(int32)
rearBeamFixedAnchor8	后梁固定锚杆8#，状态：1正常2未连接3未使用4报警	body	false	integer(int32)
rightRearBeamAnchor	右后梁锚杆(kN)	body	false	number(double)
windSpeed	风速(m/s)	body	false	number(double)

请求示例：


xxxxxxxxxx
{
  "devSn": "1",
  "hangingBasketSomeone": 1,
  "windSpeed": 0.00,
  "bottomFilmHeightLeft": 0.00,
  "bottomFilmHeightRight": 0.00,
  "bottomFilmHeightDifference": 0.00,
  "leftRearBeamAnchor": 0.00,
  "rightRearBeamAnchor": 0.00,
  "rearBeamFixedAnchor1": 0,
  "rearBeamFixedAnchor2": 0,
  "rearBeamFixedAnchor3": 0,
  "rearBeamFixedAnchor4": 0,
  "rearBeamFixedAnchor5": 0,
  "rearBeamFixedAnchor6": 0,
  "rearBeamFixedAnchor7": 0,
  "rearBeamFixedAnchor8": 0,
  "inclination": 0.00
}

响应示例：

失败：


xxxxxxxxxx
{
  "success": false,
  "message": "设备编号不正确",
  "code": 5000,
  "result": null,
  "timestamp": "1677809107994"
}

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1677809789150"
}

2、添加挂篮位移数据信息

接口描述：	添加挂篮位移数据信息
请求URL:	/xmgl/hangBasketDisplacementData/add
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	参数说明	请求类型	是否必须	数据类型
devSn	设备编码	body	true	string
diamondFrameDisplacement	菱形架位移(m)	body	false	number(double)
diamondFrameSpeed	菱形架速度(m/s)	body	false	number(double)

请求示例：


xxxxxxxxxx
{
  "devSn": "1",
  "diamondFrameSpeed": 0.00,
  "diamondFrameDisplacement": 0.00
}

响应示例：

失败：


xxxxxxxxxx
{
  "success": false,
  "message": "设备编号不正确",
  "code": 5000,
  "result": null,
  "timestamp": "1677809107994"
}

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1677809789150"
}

3、添加挂篮告警数据信息

接口描述：	添加挂篮告警数据信息
请求URL:	/xmgl/hangBasketAlarmData/add
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	参数说明	请求类型	是否必须	数据类型
devSn	设备sn	body	true	string
alarmBeginTime	开始时间(格式：yyyy-MM-dd HH:mm:ss)	body	false	string(date-time)
alarmEndTime	结束时间(格式：yyyy-MM-dd HH:mm:ss)	body	false	string(date-time)
alarmName	告警名称	body	false	string
content	内容	body	false	string

请求示例：


xxxxxxxxxx
{
  "devSn": "1",
  "alarmName": "",
  "content": "",
  "alarmBeginTime": "2024-01-27 10:12:51",
  "alarmEndTime": "2024-01-27 10:12:51"
}

响应示例：

失败：


xxxxxxxxxx
{
  "success": false,
  "message": "设备编号不正确",
  "code": 5000,
  "result": null,
  "timestamp": "1677809107994"
}

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1677809789150"
}

压力试验机对接

1、添加试验检测管理数据信息

接口描述：	添加试验检测管理数据信息
请求URL:	/xmgl/pressureTestMachineManage/add
请求方式:	POST
Content-Type：	application/json

请求参数：

PressureTestMachineManage实体类

参数名称	参数说明	请求类型	是否必须	数据类型	schema
devSn	设备编码	body	true	string
age	龄期(天)	body	false	string
constructionPart	施工部位	body	false	string
designStrength	设计强度	body	false	string
equipmentStrength	设备强度	body	false	string
intensityRepresentativeValue	强度代表值(Mpa)	body	false	number(double)
nominalDiameter	公称直径(mm)	body	false	number(double)
operator	操作员	body	false	string
productionTime	制件时间(格式：yyyy-MM-dd HH:mm:ss)	body	false	string(date-time)
specimenAge	试件龄期	body	false	number(double)
specimenArea	试件面积	body	false	number(double)
specimenNum	试件数量	body	false	string
specimenSize	试件尺寸	body	false	string
status	状态：1合格2不合格3未判定	body	false	integer(int32)
testNumber	试验编号	body	false	string
testTime	试验时间（试验开始时间）(格式：yyyy-MM-dd HH:mm:ss)	body	false	string(date-time)
testType	试验类型:1混凝土试件抗压强度试验,2钢筋试验,3钢筋焊接接头试验,4钢筋机械连接接头试验,5水泥砂浆立方体抗压强度试验,6水泥砂浆立方体抗压强度试验(建筑),7水泥净浆物理性能试验,8水泥胶砂强度试验,9水泥胶砂抗折试验,10水泥净浆抗折试验,11水泥混凝土圆柱体轴心抗压强度试验,12后张预应力孔道压浆抗压强度试验,13后张预应力孔道压浆抗折强度试验,14无机结合料稳定材料无侧限抗压强度试验,15复检钢筋焊接接头试验,16复检钢筋机械连接接头试验	body	false	integer(int32)
blockNumbers	试块编号列表	body	false	array	PressureTestMachineManageBlockNumber实体类

PressureTestMachineManageBlockNumber实体类

参数名称	参数说明	请求类型	是否必须	数据类型	schema
testNumber	试块编号	body	true	string
flexuralAndCompressiveStrength	抗折/抗压强度	body	false	number(double)
loadForceValue	荷载力值(kN/m2)	body	false	number(double)
blockDatas	试块数值列表	body	false	array	PressureTestMachineManageBlockData实体类

PressureTestMachineManageBlockData实体类

参数名称	参数说明	请求类型	是否必须	数据类型	schema
code	code	body	false	number(double)
value	value	body	false	number(double)

请求示例：


xxxxxxxxxx
{
  "devSn": "1",
  "testNumber": "",
  "testType": 1,
  "specimenNum": "",
  "age": "",
  "designStrength": "",
  "intensityRepresentativeValue": 0.00,
  "testTime": "2024-01-27 11:15:07",
  "productionTime": "2024-01-27 11:15:07",
  "status": 1,
  "operator": "",
  "equipmentStrength": "",
  "specimenSize": "",
  "specimenAge": 0.00,
  "specimenArea": 0.00,
  "nominalDiameter": 0.00,
  "constructionPart": "",
  "blockNumbers": [
    {
      "testNumber": "",
      "loadForceValue": 0.00,
      "flexuralAndCompressiveStrength": 0.00,
      "blockDatas": [
        {
          "code": 0.00,
          "value": 0.00
        }
      ]
    }
  ]
}

响应示例：

失败：


xxxxxxxxxx
{
  "success": false,
  "message": "设备编号不正确",
  "code": 5000,
  "result": null,
  "timestamp": "1677809107994"
}

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1677809789150"
}

万能试验机对接

1、添加万能试验机管理数据信息

接口描述：	添加万能试验机管理数据信息
请求URL:	/xmgl/universalTestManage/add
请求方式:	POST
Content-Type：	application/json

请求参数：

UniversalTestManage实体类

参数名称	参数说明	请求类型	是否必须	数据类型	schema
devSn	设备编码	body	true	string
intensityRepresentativeValue	强度代表值(Mpa)	body	false	number(double)
nominalCrossSectionalArea	公称截面面积(mm2)	body	false	string
nominalDiameter	公称直径(mm)	body	false	number(double)
operator	操作员	body	false	string
productionTime	制件时间(格式：yyyy-MM-dd HH:mm:ss)	body	false	string(date-time)
specimenNum	试件数量	body	false	string
status	状态：1合格2不合格3未判定	body	false	integer(int32)
steelBarGrade	钢筋牌号	body	false	string
testNumber	试验编号	body	false	string
testTime	试验时间（试验开始时间）(格式：yyyy-MM-dd HH:mm:ss)	body	false	string(date-time)
testType	试验类型:1混凝土试件抗压强度试验,2钢筋试验,3钢筋焊接接头试验,4钢筋机械连接接头试验,5水泥砂浆立方体抗压强度试验,6水泥砂浆立方体抗压强度试验(建筑),7水泥净浆物理性能试验,8水泥胶砂强度试验,9水泥胶砂抗折试验,10水泥净浆抗折试验,11水泥混凝土圆柱体轴心抗压强度试验,12后张预应力孔道压浆抗压强度试验,13后张预应力孔道压浆抗折强度试验,14无机结合料稳定材料无侧限抗压强度试验,15复检钢筋焊接接头试验,16复检钢筋机械连接接头试验	body	false	integer(int32)
blockNumberList	万能试验机管理-试块编号列表	body	false	array	UniversalTestManageBlockNumber实体类

UniversalTestManageBlockNumber实体类

参数名称	参数说明	请求类型	是否必须	数据类型	schema
elongation	伸长率(%)	body	false	number(double)
maximumBreakingForce	拉断最大力值(KN)	body	false	number(double)
pitTensileStrength	坑拉强度(Mpa)	body	false	number(double)
testNumber	试块编号	body	false	string
yieldPoint	屈服点(KN)	body	false	number(double)
yieldPointStrength	屈服点强度(Mpa)	body	false	number(double)
blockDataList	万能试验机管理-试块数值列表	body	false	array	UniversalTestManageBlockData实体类

UniversalTestManageBlockData实体类

参数名称	参数说明	请求类型	是否必须	数据类型
code	code	body	false	number(double)
value	value	body	false	number(double)
type	类型：1力值2位移	body	false	integer(int32)

请求示例：


xxxxxxxxxx
{
  "devSn": "1",
  "testNumber": "",
  "testType": 1,
  "specimenNum": "",
  "testTime": "2024-01-27 11:37:54",
  "status": 1,
  "productionTime": "2024-01-27 11:37:54",
  "operator": "",
  "steelBarGrade": "",
  "nominalDiameter": 0.00,
  "intensityRepresentativeValue": 0.00,
  "nominalCrossSectionalArea": "",
  "affiliatedLaboratory": "",
  "blockNumberList": [
    {
      "testNumber": "",
      "maximumBreakingForce": 0.00,
      "yieldPoint": 0.00,
      "yieldPointStrength": 0.00,
      "pitTensileStrength": 0.00,
      "elongation": 0.00,
      "blockDataList": [
        {
          "code": 0.00,
          "value": 0.00,
          "type": 1
        }
      ]
    }
  ]
}

响应示例：

失败：


xxxxxxxxxx
{
  "success": false,
  "message": "设备编号不正确",
  "code": 5000,
  "result": null,
  "timestamp": "1677809107994"
}

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1677809789150"
}

抗压抗折一体机对接

1、添加抗压抗折一体机-管理数据信息

接口描述：	添加抗压抗折一体机-管理数据信息
请求URL:	/xmgl/antiPressureFoldManage/add
请求方式:	POST
Content-Type：	application/json

请求参数：

AntiPressureFoldManage实体类

参数名称	参数说明	请求类型	是否必须	数据类型	schema
devSn	设备编码	body	true	string
age	龄期(天)	body	false	string
constructionPart	施工部位	body	false	string
designStrength	设计强度	body	false	string
equipmentStrength	设备强度	body	false	string
intensityRepresentativeValue	强度代表值(Mpa)	body	false	number(double)
nominalDiameter	公称直径(mm)	body	false	number(double)
operator	操作员	body	false	string
productionTime	制件时间(格式：yyyy-MM-dd HH:mm:ss)	body	false	string(date-time)
specimenAge	试件龄期	body	false	number(double)
specimenArea	试件面积	body	false	number(double)
specimenNum	试件数量	body	false	string
specimenSize	试件尺寸	body	false	string
status	状态：1合格2不合格3未判定	body	false	integer(int32)
testNumber	试验编号	body	false	string
testTime	试验时间（试验开始时间）(格式：yyyy-MM-dd HH:mm:ss)	body	false	string(date-time)
testType	试验类型:1混凝土试件抗压强度试验,2钢筋试验,3钢筋焊接接头试验,4钢筋机械连接接头试验,5水泥砂浆立方体抗压强度试验,6水泥砂浆立方体抗压强度试验(建筑),7水泥净浆物理性能试验,8水泥胶砂强度试验,9水泥胶砂抗折试验,10水泥净浆抗折试验,11水泥混凝土圆柱体轴心抗压强度试验,12后张预应力孔道压浆抗压强度试验,13后张预应力孔道压浆抗折强度试验,14无机结合料稳定材料无侧限抗压强度试验,15复检钢筋焊接接头试验,16复检钢筋机械连接接头试验	body	false	integer(int32)
blockNumberList	抗压抗折一体机-试块编号列表	body	false	array	AntiPressureFoldManageBlockNumber实体类

AntiPressureFoldManageBlockNumber实体类

参数名称	参数说明	请求类型	是否必须	数据类型	schema
flexuralAndCompressiveStrength	抗折/抗压强度	body	false	number(double)
loadForceValue	荷载力值(kN/m2)	body	false	number(double)
testNumber	试块编号	body	false	string
blockDataList	抗压抗折一体机-试块数值列表	body	false	array	AntiPressureFoldManageBlockData实体类

AntiPressureFoldManageBlockData实体类

参数名称	参数说明	请求类型	是否必须	数据类型	schema
code	code	body	false	number(double)
value	value	body	false	number(double)

请求示例：


xxxxxxxxxx
{
  "devSn": "1",
  "testNumber": "",
  "testType": 1,
  "specimenNum": "",
  "age": "",
  "designStrength": "",
  "intensityRepresentativeValue": 0,
  "testTime": "2024-01-27 11:46:44",
  "productionTime": "2024-01-27 11:46:44",
  "status": 1,
  "constructionPart": "",
  "operator": "",
  "equipmentStrength": "",
  "specimenSize": "",
  "specimenAge": 0,
  "specimenArea": 0,
  "nominalDiameter": 0,
  "blockNumberList": [
    {
      "testNumber": "",
      "loadForceValue": 0,
      "flexuralAndCompressiveStrength": 0,
      "blockDataList": [
        {
          "code": 0,
          "value": 0
        }
      ]
    }
  ]
}

响应示例：

失败：


xxxxxxxxxx
{
  "success": false,
  "message": "设备编号不正确",
  "code": 5000,
  "result": null,
  "timestamp": "1677809107994"
}

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1677809789150"
}

混凝土拌合站对接

1、添加混凝土拌合站生产数据信息

接口描述：	添加混凝土拌合站生产数据信息
请求URL:	/xmgl/concreteMixStationData/add
请求方式:	POST
Content-Type：	application/json

请求参数：

ConcreteMixStationData实体类

参数名称	参数说明	请求类型	是否必须	数据类型	schema
devSn	设备sn	body	true	string
actualQuantity	实际方量(m3)	body	false	number(double)
constructionMixRatio	施工配合比	body	false	string
constructionSite	施工地点	body	false	string
dischargeTime	出料时间(格式：yyyy-MM-dd HH:mm:ss)	body	false	string(date-time)
operator	操作员	body	false	string
pouringPart	浇筑部位	body	false	string
powerLevel	强度等级	body	false	string
stirringTime	搅拌时长	body	false	string
taskNumber	任务单号	body	false	string
useStatus	使用状态：1正常2初级超标3中级超标4高级超标5异常	body	false	integer(int32)
waterBinderRatio	水胶比	body	false	number(double)
materialDataList	混凝土拌合站材料用量数据列表	body	false	array	ConcreteMixStationMaterialData实体类

ConcreteMixStationMaterialData实体类

参数名称	参数说明	请求类型	是否必须	数据类型
actualAmount	实际用量(kg)	body	false	number(double)
error	误差(%)	body	false	number(double)
materialName	材料名称	body	false	string
theoreticalDosage	理论用量(kg)	body	false	number(double)

请求示例：


xxxxxxxxxx
{
  "devSn": "1",
  "taskNumber": "",
  "pouringPart": "",
  "powerLevel": "",
  "actualQuantity": 0.00,
  "waterBinderRatio": 0.00,
  "dischargeTime": "2024-01-27 11:54:54",
  "useStatus": 1,
  "constructionMixRatio": "",
  "stirringTime": "",
  "constructionSite": "",
  "operator": "",
  "materialDataList": [
    {
      "materialName": "",
      "theoreticalDosage": 0.00,
      "actualAmount": 0.00,
      "error": 0.00
    }
  ]
}

响应示例：

失败：


xxxxxxxxxx
{
  "success": false,
  "message": "设备编号不正确",
  "code": 5000,
  "result": null,
  "timestamp": "1677809107994"
}

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1677809789150"
}

沥青拌合站对接

1、添加沥青拌合站生产数据信息

接口描述：	添加沥青拌合站生产数据信息
请求URL:	/xmgl/pitchMixStationProdData/add
请求方式:	POST
Content-Type：	application/json

请求参数：

PitchMixStationProdData实体类

参数名称	参数说明	请求类型	是否必须	数据类型	schema
devSn	设备sn	body	true	string
constructionSite	施工地点	body	false	string
dischargeTime	出料时间(格式：yyyy-MM-dd HH:mm:ss)	body	false	string(date-time)
operator	操作员	body	false	string
plateWeight	盘重	body	false	number(double)
projectName	工程名称	body	false	string
proportionName	配比名称	body	false	string
taskNumber	任务单号	body	false	string
useLayer	使用层	body	false	string
useStatus	使用状态：1正常2初级超标3中级超标4高级超标5异常	body	false	integer(int32)
whetstoneRatio	油石比	body	false	number(double)
materialDataList	沥青拌合站材料用量数据列表	body	false	array	PitchMixStationMaterialData实体类

PitchMixStationMaterialData实体类

参数名称	参数说明	请求类型	是否必须	数据类型
actualAmount	实际用量(kg)	body	false	number(double)
error	误差(%)	body	false	number(double)
materialName	材料名称	body	false	string
theoreticalDosage	理论用量(kg)	body	false	number(double)

请求示例：


xxxxxxxxxx
{
  "devSn": "设备编码",
  "taskNumber": "",
  "projectName": "",
  "proportionName": "",
  "plateWeight": 0.00,
  "whetstoneRatio": 0.00,
  "useLayer": "",
  "dischargeTime": "2024-01-27 14:06:15",
  "useStatus": 1,
  "constructionSite": "",
  "operator": "",
  "materialDataList": [
    {
      "materialName": "",
      "theoreticalDosage": 0.00,
      "actualAmount": 0.00,
      "error": 0.00
    }
  ]
}

响应示例：

失败：


xxxxxxxxxx
{
  "success": false,
  "message": "设备编号不正确",
  "code": 5000,
  "result": null,
  "timestamp": "1677809107994"
}

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1677809789150"
}

路面摊铺对接

1、添加路面摊铺-记录信息

接口描述：	添加路面摊铺-记录信息
请求URL:	/xmgl/paveRecord/add
请求方式:	POST
Content-Type：	application/json

请求参数：

PaveRecord实体类

参数名称	参数说明	请求类型	是否必须	数据类型
devSn	设备编码	body	true	string
amplitude	振幅	body	false	number(double)
averagePaveTemp	平均摊铺温度(C)	body	false	number(double)
averagePaveThickness	平均摊铺厚度(mm)	body	false	number(double)
frequency	频率(Hz)	body	false	number(double)
geographicalLatitude	地理纬度(N/S)	body	false	number(double)
geographicalLongitude	地理经度(W/E)	body	false	number(double)
paveSpeed	摊铺速度(m/min)	body	false	number(double)
paveTime	摊铺时间(格式：yyyy-MM-dd HH:mm:ss)	body	false	string(date-time)
sensor10PaveTemp	传感器10-摊铺温度(C)	body	false	number(double)
sensor1PaveTemp	传感器1-摊铺温度(C)	body	false	number(double)
sensor1PaveThickness	传感器1-摊铺厚度(C)	body	false	number(double)
sensor2PaveTemp	传感器2-摊铺温度(C)	body	false	number(double)
sensor2PaveThickness	传感器2-摊铺厚度(C)	body	false	number(double)
sensor3PaveTemp	传感器3-摊铺温度(C)	body	false	number(double)
sensor3PaveThickness	传感器3-摊铺厚度(C)	body	false	number(double)
sensor4PaveTemp	传感器4-摊铺温度(C)	body	false	number(double)
sensor4PaveThickness	传感器4-摊铺厚度(C)	body	false	number(double)
sensor5PaveTemp	传感器5-摊铺温度(C)	body	false	number(double)
sensor6PaveTemp	传感器6-摊铺温度(C)	body	false	number(double)
sensor7PaveTemp	传感器7-摊铺温度(C)	body	false	number(double)
sensor8PaveTemp	传感器8-摊铺温度(C)	body	false	number(double)
sensor9PaveTemp	传感器9-摊铺温度(C)	body	false	number(double)

请求示例：


xxxxxxxxxx
{
  "devSn": "",
  "paveSpeed": 0,
  "averagePaveTemp": 0,
  "averagePaveThickness": 0,
  "amplitude": 0,
  "frequency": 0,
  "geographicalLongitude": 0,
  "geographicalLatitude": 0,
  "paveTime": "2024-01-27 14:15:24",
  "sensor1PaveTemp": 0,
  "sensor2PaveTemp": 0,
  "sensor3PaveTemp": 0,
  "sensor4PaveTemp": 0,
  "sensor5PaveTemp": 0,
  "sensor6PaveTemp": 0,
  "sensor7PaveTemp": 0,
  "sensor8PaveTemp": 0,
  "sensor9PaveTemp": 0,
  "sensor10PaveTemp": 0,
  "sensor1PaveThickness": 0,
  "sensor2PaveThickness": 0,
  "sensor3PaveThickness": 0,
  "sensor4PaveThickness": 0
}

响应示例：

失败：


xxxxxxxxxx
{
  "success": false,
  "message": "设备编号不正确",
  "code": 5000,
  "result": null,
  "timestamp": "1677809107994"
}

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1677809789150"
}

路面压实对接

1、添加路面压实-记录信息

接口描述：	添加路面压实-记录信息
请求URL:	/xmgl/paveCompactionRecord/add
请求方式:	POST
Content-Type：	application/json

请求参数：

PaveCompactionRecord实体类

参数名称	参数说明	请求类型	是否必须	数据类型
devSn	设备编码	body	true	string
amplitude	振幅	body	false	number(double)
averagePaveTemp	平均压实温度(C)	body	false	number(double)
frequency	频率(Hz)	body	false	number(double)
geographicalLatitude	地理纬度(N/S)	body	false	number(double)
geographicalLongitude	地理经度(W/E)	body	false	number(double)
paveDegree	压实度(mm)	body	false	number(double)
paveSpeed	压实速度(m/min)	body	false	number(double)
paveTime	压实时间(格式：yyyy-MM-dd HH:mm:ss)	body	false	string(date-time)
sensor10PaveTemp	传感器10-压实温度(C)	body	false	number(double)
sensor1PaveDegree	传感器1-压实度(C)	body	false	number(double)
sensor1PaveTemp	传感器1-压实温度(C)	body	false	number(double)
sensor2PaveDegree	传感器2-压实度(C)	body	false	number(double)
sensor2PaveTemp	传感器2-压实温度(C)	body	false	number(double)
sensor3PaveDegree	传感器3-压实度(C)	body	false	number(double)
sensor3PaveTemp	传感器3-压实温度(C)	body	false	number(double)
sensor4PaveDegree	传感器4-压实度(C)	body	false	number(double)
sensor4PaveTemp	传感器4-压实温度(C)	body	false	number(double)
sensor5PaveTemp	传感器5-压实温度(C)	body	false	number(double)
sensor6PaveTemp	传感器6-压实温度(C)	body	false	number(double)
sensor7PaveTemp	传感器7-压实温度(C)	body	false	number(double)
sensor8PaveTemp	传感器8-压实温度(C)	body	false	number(double)
sensor9PaveTemp	传感器9-压实温度(C)	body	false	number(double)

请求示例：


xxxxxxxxxx
{
  "devSn": "1",
  "paveSpeed": 0.00,
  "averagePaveTemp": 0.00,
  "paveDegree": 0.00,
  "amplitude": 0.00,
  "frequency": 0.00,
  "geographicalLongitude": 0.00,
  "geographicalLatitude": 0.00,
  "paveTime": "2024-01-27 14:18:47",
  "sensor1PaveTemp": 0.00,
  "sensor2PaveTemp": 0.00,
  "sensor3PaveTemp": 0.00,
  "sensor4PaveTemp": 0.00,
  "sensor5PaveTemp": 0.00,
  "sensor6PaveTemp": 0.00,
  "sensor7PaveTemp": 0.00,
  "sensor8PaveTemp": 0.00,
  "sensor9PaveTemp": 0.00,
  "sensor10PaveTemp": 0.00,
  "sensor1PaveDegree": 0.00,
  "sensor2PaveDegree": 0.00,
  "sensor3PaveDegree": 0.00,
  "sensor4PaveDegree": 0.00
}

响应示例：

失败：


xxxxxxxxxx
{
  "success": false,
  "message": "设备编号不正确",
  "code": 5000,
  "result": null,
  "timestamp": "1677809107994"
}

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1677809789150"
}

智能安全帽对接

1、添加智能安全帽-实时数据信息

接口描述：	添加智能安全帽-实时数据信息
请求URL:	/xmgl/safetyHatData/add
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	参数说明	请求类型	是否必须	数据类型
devSn	设备序号	body	true	string
latitude	当前位置维度x	body	true	number(double)
longitude	当前位置经度y	body	true	number(double)
uploadTime	上传时间（yyyy-MM-dd HH:mm:ss）	body	true	string

请求示例：


xxxxxxxxxx
{
    "devSn": "1",
    "latitude": 0,
    "longitude": 0,
    "uploadTime":"2024-03-18 15:05:00"
}

响应示例：

失败：


xxxxxxxxxx
{
  "success": false,
  "message": "设备编号不正确",
  "code": 5000,
  "result": null,
  "timestamp": "1677809107994"
}

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1677809789150"
}

2、添加智能安全帽-报警信息

接口描述：	添加智能安全帽-报警信息
请求URL:	/xmgl/safetyHatAlarm/add
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	参数说明	请求类型	是否必须	数据类型
devSn	设备序号	body	true	string
alarmTime	报警时间（yyyy-MM-dd HH:mm:ss）	body	false	string(date-time)
alarmType	报警类型（1 脱帽报警 2 围栏报警1 离开工作区域 3 温度报警 4 跌落（撞击）报警 5 围栏报警2 进入禁区 6 静默报警 7 SOS报警 11 近电报警 12 登高报警 17 进入蓝牙信标报警 18 离开蓝牙信标报警 13、15 氧气报警 14、16 甲烷报警 19 一氧化碳浓度 20 体温报警 21 心率报警 22 血压报警）	body	false	integer(int32)
latitude	当前位置维度x	body	false	number(double)
longitude	当前位置经度y	body	false	number(double)

请求示例：


xxxxxxxxxx
{
    "devSn": "1",
    "alarmTime": "2024-03-18 15:05:00",
    "alarmType": 1,
    "latitude": 0,
    "longitude": 0
}

响应示例：

失败：


xxxxxxxxxx
{
  "success": false,
  "message": "设备编号不正确",
  "code": 5000,
  "result": null,
  "timestamp": "1677809107994"
}

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1677809789150"
}

3、更新智能安全帽在线离线状态

接口描述：	更新智能安全帽在线离线状态
请求URL:	/xmgl/safetyHatData/updateStatus
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	参数说明	请求类型	是否必须	数据类型
devSn	设备序号	body	true	string
online	在线状态（0.离线 1.在线）	body	true	number(double)

请求示例：


xxxxxxxxxx
{
    "devSn": "1",
    "online": 1
}

响应示例：

失败：


xxxxxxxxxx
{
  "success": false,
  "message": "设备编号不正确",
  "code": 5000,
  "result": null,
  "timestamp": "1677809107994"
}

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1677809789150"
}

机械设备定位对接

1、添加机械设备定位-实时数据信息

接口描述：	添加机械设备定位-实时数据信息
请求URL:	/xmgl/mechanicalEquipmentPositionData/add
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	参数说明	请求类型	是否必须	数据类型
devSn	设备序号	body	true	string
equipmentPower	设备电量	body	false	number(double)
equipmentVoltage	设备电压	body	false	number(double)
latitude	当前位置维度x	body	false	number(double)
longitude	当前位置经度y	body	false	number(double)
speed	速度	body	false	number(double)
uploadTime	上传时间（yyyy-MM-dd HH:mm:ss）	body	false	string(date-time)
workStatus	工作状态（1：ACC开(工作状态)，2：ACC关(怠速状态）	body	false	integer(int32)

请求示例：


xxxxxxxxxx
{
    "devSn": "1",
    "equipmentPower": 10,
    "equipmentVoltage": 20,
    "latitude": 1,
    "longitude": 2,
    "speed": 1,
    "uploadTime": "2024-03-18 15:05:00",
    "workStatus": 1
}

响应示例：

失败：


xxxxxxxxxx
{
  "success": false,
  "message": "设备编号不正确",
  "code": 5000,
  "result": null,
  "timestamp": "1677809107994"
}

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1677809789150"
}

2、添加机械设备定位-报警信息

接口描述：	添加机械设备定位-报警信息
请求URL:	/xmgl/mechanicalEquipmentPositionAlarm/add
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	参数说明	请求类型	是否必须	数据类型
devSn	设备序号	body	true	string
alarmInfo	报警信息	body	false	string
alarmTime	报警时间	body	false	string(date-time)

请求示例：


xxxxxxxxxx
{
    "devSn": "1",
    "alarmInfo": "报警信息",
    "alarmTime": "2024-03-18 15:05:00"
}

响应示例：

失败：


xxxxxxxxxx
{
  "success": false,
  "message": "设备编号不正确",
  "code": 5000,
  "result": null,
  "timestamp": "1677809107994"
}

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1677809789150"
}

3、机械工时通转发数据到平台

接口描述：	转发添加机械设备定位-实时和报警数据信息
请求URL:	/xmgl/mechanicalEquipmentPositionData/addData
请求方式:	POST
Content-Type：	application/json

请求参数：

Speed：速度 Time：当前时间 deviceid：设备id devicename：设备名称 lon：经度 lat：纬度 stralarm：拆除报警信息 strstatus：工作状态（ACC开为工作状态，ACC关为怠速状态） supplyvoltage：设备电压（根据电压值计算电量百分比，3.7-4.2（0%-100%）） voltagepercent：设备电量

请求示例：

code=200的情况


xxxxxxxxxx
{
  "Altitude": 0,
  "Code": 200,
  "Direction": 121,
  "Speed": 0,
  "Time": "2024-03-10 04:52:19",
  "deviceid": 61136981730,
  "devicename": 61136981730,
  "lat": "22.734326",
  "lon": "114.243999",
  "stralarm": "拆除报警",
  "strstatus": "ACC关",
  "supplyvoltage": "0.00",
  "voltagepercent": 22
}

code=704的情况，解析平台重启后回补数据，在外面封装了一层，里面内容一样


xxxxxxxxxx
{
  "Code": 704,
  "Items": [
    {
      "Altitude": 0,
      "Code": 200,
      "Direction": 121,
      "Speed": 0,
      "Time": "2024-03-10 04:49:19",
      "deviceid": 61136981730,
      "devicename": 61136981730,
      "lat": "22.734326",
      "lon": "114.243999",
      "stralarm": "拆除报警",
      "strstatus": "ACC关",
      "supplyvoltage": "3.70",
      "voltagepercent": 0
    }
  ],
  "Type": 1
}

4.机械指挥官更新设备状态和信息

推送地址：/xmgl/mechanicalEquipmentPositionData/jxzhgUpdateStatus

https://www.yuque.com/u27244850/zuklv1/qil21b?#M2jFz

接口说明

当机械实时信息发生变化时，即机械速度、状态、定位等发生改变时，系统自动给接入方系统推送实时状态信息。

包含：机械实时状态、硬件实时状态、定位、油位、正反转、角度等信息。

交互方式

传输协议：HTTP
请求方法：POST
编码格式：UTF-8
传输格式：JSON
推送地址：接入方配置推送地址

推送参数

参数名	类型	参数含义	备注
tenant_key	[string]	企业唯一标识
project_info	[object]	项目信息
	project_key	[string]	项目唯一标识
	project_number	[string]	项目编号
	project_name	[string]	项目名称
machine_info	[object]	机械信息
	machine_uuid	[string]	机械唯一标识
	machine_name	[string]	机械名称
	vehicle_license_code	[string]	车牌号
	factory_code	[string]	铭牌编号
	management_code	[string]	管理编号
	assets_code	[string]	资产编号
state_info	[object]	机械状态
	machine_state	[string]	机械实时状态（取这个）	'working'：工作；'off'：静止；'out_watching'：离线；'idle'：怠速；
	state_update_time	[number]	状态更新时间（取这个）	时间戳
	state_standing_time	[number]	状态持续时间	单位 : 秒 (s)
device_info	[array]	终端信息
	sn	[string]	终端sn（取这个）	没有绑定终端返回null
	hardware_type	[string]	终端类型	Z03.0、Z03.1 ...
	hardware_state	[string]	终端状态	'normal' : 正常'fault' : 异常'offline' : 离线'shutdown' :关机
	updated_at	[string]	状态更新时间
sensor_infos	[array]	传感器信息
	sn	[array]	传感器sn	没有绑定传感器返回null
	hardware_type	[string]	传感器类型	SP1.0、SP1.1 、ZP1.0...
	hardware_state	[string]	传感器状态	'working' :正常'off' :离线
	updated_at	[string]	状态更新时间	yyyy-MM-dd HH:mm:ss
location_info	[object]	定位信息
	address	[string]	地址
	longitude	[number]	经度（取这个）
	latitude	[number]	纬度（取这个）
	altitude	[number]	海拔高度	单位：米
	speed	[number]	速度（取这个）	单位：千米/小时（km/h）
	direction	[string]	方向	东南等
	present_ts	[number]	状态更新时间	时间戳
fuel_info	[object]	油位数据
	fuel_percentage	[string]	油量百分比
	fuel_volume	[string]	油量值	单位：升（L）
	tank_id	[string]	油箱标识	0：主油箱1：副油箱
	fuel_update_ts	[string]	状态更新时间	时间戳
rotate_info	[object]	正反转状态
	rotate_state	[string]	正反转状态	'forward'：正转'reverse':：反转'off'：停转
	rotate_standing_time	[number]	状态持续时长	单位 : 秒 (s)
	rotate_state_update_ts	[string]	状态更新时间	时间戳
angle_info	[object]	角度数据
	sa_angle	[number]	角度	单位：度（°）
	angle_state_update_ts	[string]	状态更新时间	时间戳
load_info	[object]	载重数据
	load_state	[string]	载重状态
	load_state_update_ts	[string]	载重状态更新时间	时间戳
	load_value	[number]	载重	单位：吨
	load_percentage	[string]	载重百分比	单位：%

推送示例


xxxxxxxxxx
[{
      "tenant_key": "W6FFFFFF",
      "project_info": {
        "project_key": null,
        "project_name": null,
        "project_number": null
                    },
      "machine_info": {
        "machine_uuid": "W6FF8CRP",
        "machine_name": "汽车吊gcn",
        "vehicle_license_code": null,
        "factory_code": "TC2025BK4669",
        "management_code": null,
        "assets_code": null
      },
      "state_info": {
        "machine_state": "out_watching",
        "state_update_time": 1650184016,
        "state_standing_time": 0
      },
      "device_info": [{
        "sn": "Z30184600185",
        "hardware_type": "Z03.0",
        "hardware_state": "offline",
        "updated_at": "2022-04-17 16:26:56"
      }],
      "sensor_infos": [{
        "sn": ["SA11A34738"],
        "hardware_type": "SA1.1",
        "hardware_state": "working",
        "updated_at": "2022-04-11 10:06:32"
      }, {
        "sn": ["SN1900112"],
        "hardware_type": "SP1.0",
        "hardware_state": "working",
        "updated_at": "2022-04-11 13:57:20"
      }],
      "location_info": {
        "address": null,
        "longitude": 118.87943962856022,
        "latitude": 32.098986811779376,
        "speed": 30,
        "direction": null,
        "present_ts": 1650076466
      },
      "fuel_info": [{
        "fuel_percentage": 0.46,
        "fuel_volume": 95,
        "tank_id": 0,
        "fuel_update_ts": null
      }, {
        "fuel_percentage": 0,
        "fuel_volume": null,
        "tank_id": 1,
        "fuel_update_ts": null
      }],
      "rotate_info": {
        "rotate_state": "off",
        "rotate_standing_time": 6,
        "rotate_state_update_ts": 1650188079
      },
      "angle_info": {
        "sa_angle": 20,
        "angle_state_update_ts": 1650184016
      }
}]

安全宝对接

1、添加安全宝-人员课程信息信息

接口描述：	添加安全宝-人员课程信息信息
请求URL:	/xmgl/securityWorkerCourseInfo/add
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	参数说明	请求类型	数据类型
idCard	身份证号	body	string
workerName	姓名	body	string
courseName	课程名称	body	string
coursePeriod	课程所在学时	body	string

请求示例：


xxxxxxxxxx
{
    "courseName": "防火",
    "coursePeriod": "1小时",
    "idCard": "210311198801203011",
    "workerName": "张三"
}

响应示例：

失败：


xxxxxxxxxx
{
    "success": false,
    "message": "平台不存在该人员",
    "code": 5000,
    "result": null,
    "timestamp": "1716615826037"
}

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1716615710867"
}

VR安全体验对接

1、添加VR安全体验-人员登录信息信息

接口描述：	添加VR安全体验-人员登录信息信息
请求URL:	/xmgl/vrSecurityWorkerLoginInfo/add
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	参数说明	请求类型	数据类型
idCard	身份证号	body	string
workerName	姓名	body	string
loginNum	登录次数	body	integer

请求示例：


xxxxxxxxxx
{
    "idCard": "210311198801203011",
    "loginNum": 1,
    "workerName": "张三"
}

响应示例：

失败：


xxxxxxxxxx
{
    "success": false,
    "message": "平台不存在该人员",
    "code": 5000,
    "result": null,
    "timestamp": "1716615966446"
}

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1716615959255"
}

车辆测速对接

1、添加车辆测速数据信息

接口描述：	添加车辆测速数据信息
请求URL:	/xmgl/carMeasureSpeedData/add
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	参数说明	请求类型	是否必须	数据类型
devSn	设备编号	body	true	string
carNumber	车牌号	body	false	string
currentSpeed	当前车速(km/h)	body	false	number
exceedingThreshold	超出阈值多少	body	false	number
isExceed	是否超出阈值1是0否	body	false	int
snapshotImageBase64	抓拍图片base64	body	false	string
uploadTime	上传时间yyyy-MM-dd HH:mm:ss	body	false	string

请求示例：


xxxxxxxxxx
{
    "devSn": "123123",
    "carNumber": "粤A11111",
    "currentSpeed": 60,
    "exceedingThreshold": 40,
    "isExceed": 1,
    "uploadTime": "2025-06-04 14:18:56",
    "snapshotImageBase64": "/9j/4AAQSkZJRgABAQEAYABgAAD//gAUU29mdHdhcmU6IFNuaXBhc3Rl/9sAQwADAgIDAgIDAwMDBAMDBAUIBQUEBAUKBwcGCAwKDAwLCgsLDQ4SEA0OEQ4LCxAWEBETFBUVFQwPFxgWFBgSFBUU/9sAQwEDBAQFBAUJBQUJFA0LDRQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQU/8AAEQgAAQABAwEiAAIRAQMRAf/EAB8AAAEFAQEBAQEBAAAAAAAAAAABAgMEBQYHCAkKC//EALUQAAIBAwMCBAMFBQQEAAABfQECAwAEEQUSITFBBhNRYQcicRQygZGhCCNCscEVUtHwJDNicoIJChYXGBkaJSYnKCkqNDU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6g4SFhoeIiYqSk5SVlpeYmZqio6Slpqeoqaqys7S1tre4ubrCw8TFxsfIycrS09TV1tfY2drh4uPk5ebn6Onq8fLz9PX29/j5+v/EAB8BAAMBAQEBAQEBAQEAAAAAAAABAgMEBQYHCAkKC//EALURAAIBAgQEAwQHBQQEAAECdwABAgMRBAUhMQYSQVEHYXETIjKBCBRCkaGxwQkjM1LwFWJy0QoWJDThJfEXGBkaJicoKSo1Njc4OTpDREVGR0hJSlNUVVZXWFlaY2RlZmdoaWpzdHV2d3h5eoKDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uLj5OXm5+jp6vLz9PX29/j5+v/aAAwDAQACEQMRAD8AZRRRX9Zn8GH/2Q=="
}

响应示例：

失败：


xxxxxxxxxx
{
    "success": false,
    "message": "设备编号不正确",
    "code": 5000,
    "result": null,
    "timestamp": "1749018107870"
}

成功：


xxxxxxxxxx
{
    "success": true,
    "message": "操作成功！",
    "code": 200,
    "result": null,
    "timestamp": "1716615959255"
}

汽车吊在线监测系统对接

1、添加汽车吊实时数据

接口描述：	添加汽车吊实时数据
请求URL:	/xmgl/truckCraneCurrentData/add
请求方式:	POST
Content-Type：	application/json

请求参数：

字段	类型	说明	是否必传
devSn	String	设备识别码(平台生成的唯一识别码)	是
reportTime	String	上传时间，时间格式如2021-03-08 09:23:08	是
bigArmObliguity	String	大臂倾角	是
bigArmLength	float	大臂长度	是
armStrengthLength	float	力臂长度	是
rotationAngle	float	回转角度	是
torqueRatio	float	重量	是
moment	float	力矩	是
windSpeed	float	风速	是

2、添加汽车吊报警数据

接口描述：	添加汽车吊报警数据
请求URL:	/xmgl/truckCraneAlarm/add
请求方式:	POST
Content-Type：	application/json

请求参数：

字段	类型	说明	是否必传
devSn	String	设备识别码(平台生成的唯一识别码)	是
reportTime	String	上传时间，时间格式如2021-03-08 09:23:08	是
rotation	int	回转报警(0：正常;1：报警)	是
weight	int	重量报警(0：正常;1：报警)	是
moment	int	力矩报警(0：正常;1：报警)	是
windSpeed	int	风速报警(0：正常;1：报警)	是

响应结果：

成功：


xxxxxxxxxx
{
  "success": true,
  "message": "操作成功！",
  "code": 200,
  "result": null,
  "timestamp": "1681814472197"
}

履带吊在线监测系统对接

1、添加履带吊实时数据

接口描述：	添加履带吊实时数据
请求URL:	/xmgl/crawlerCraneCurrentData/add
请求方式:	POST
Content-Type：	application/json

请求参数：

字段	类型	说明	是否必传
devSn	String	设备识别码(平台生成的唯一识别码)	是
reportTime	String	上传时间，时间格式如2021-03-08 09:23:08	是
windSpeed	String	风速	是
mainWeight	float	主钩吊重	是
mainHeight	float	主钩高度	是
mainMoment	float	主钩力矩	是
auxiliaryWeight	float	副钩吊重	是
auxiliaryHeight	float	副钩高度	是
auxiliaryMoment	float	副钩力矩	是
rearTiltLimit	float	防后倾限位	是
horizontalDegree	float	水平度	是
thresholdPosition	float	门限位	是
pitchAngle	float	俯仰角	是
devRange	float	幅度	是
rotationAngle	float	回转角度	是
rotationSpeed	float	回转速度	是

2、添加履带吊报警数据

接口描述：	添加履带吊报警数据
请求URL:	/xmgl/crawlerCraneAlarm/add
请求方式:	POST
Content-Type：	application/json

请求参数：

字段	类型	说明	是否必传
devSn	String	设备识别码(平台生成的唯一识别码)	是
reportTime	String	上传时间，时间格式如2021-03-08 09:23:08	是
rotation	int	回转报警(0：正常;1：报警)	是
mainWeight	int	主钩吊重报警(0：正常;1：报警)	是
mainHeight	int	主钩高度报警(0：正常;1：报警)	是
auxiliaryWeight	int	副钩吊重报警(0：正常;1：报警)	是
auxiliaryHeight	int	副钩高度报警(0：正常;1：报警)	是
rearTiltLimit	int	防后倾限位报警(0：正常;1：报警)	是
windSpeed	int	风速报警(0：正常;1：报警)	是

响应结果：

成功：


xxxxxxxxxx
{
  "success": true,
  "message": "操作成功！",
  "code": 200,
  "result": null,
  "timestamp": "1681814472197"
}

3、添加履带吊工作循环数据

接口描述：	添加履带吊报警数据
请求URL:	/xmgl/crawlerCraneWorkerCycle/add
请求方式:	POST
Content-Type：	application/json

请求参数：

字段	类型	说明	是否必传
devSn	String	设备识别码(平台生成的唯一识别码)	是
reportTime	String	上传时间，时间格式如2021-03-08 09:23:08	是
startTime	String	工作循环开始时间，时间格式如2021-03-08 09:23:08	是
endTime	String	工作循环结束时间，时间格式如2021-03-08 09:23:08	是
maxWindSpeed	float	最大风速	是
maxMainWeight	float	最大主钩吊重	是
maxAuxiliaryWeight	float	最大副钩吊重	是

响应结果：

成功：


xxxxxxxxxx
{
  "success": true,
  "message": "操作成功！",
  "code": 200,
  "result": null,
  "timestamp": "1681814472197"
}

盾构机在线监测系统对接

1、添加盾构机实时数据

接口描述：	添加盾构机实时数据
请求URL:	/xmgl/tunnelBoringMachineCurrentData/add
请求方式:	POST
Content-Type：	application/json

请求参数：

字段	类型	说明	是否必传
devSn	String	设备识别码	是
cutterheadHorizontalDeviation	float	刀盘水平偏差	是
cutterheadVerticalDeviation	float	刀盘垂直偏差	是
shieldHorizontalDeviation	float	盾尾水平偏差	是
shieldVerticalDeviation	float	盾尾垂直偏差	是
cutterheadTorque	float	刀盘扭矩	是
cutterheadSpeed	float	刀盘转速	是
totalThrust	float	总推力	是
totalPropulsion	float	总推进泵压力	是
advanceSpeed	float	推进速度	是
rollPosition	float	滚动角	是
upCabinPressure	float	正上舱压	是
leftCenterCabinPressure	float	左中舱压	是
leftUpCabinPressure	float	左上舱压	是
leftBelowCabinPressure	float	左下舱压	是
rightCenterCabinPressure	float	右中舱压	是
rightUpCabinPressure	float	右上舱压	是
rightBelowCabinPressure	float	右下舱压	是
reportTime	String	上传时间，时间格式如2021-03-08 09:23:08	是
verticalDeviation	String	垂直偏差趋势	是
mileageCompleted	String	已完成里程	是
currentNumber	int	当前环数	是
dayNumber	int	日推进环数	是
monthNumber	int	月推进环数	是
penetration	String	贯入度	是
pitchAngle	String	导向俯仰角	是
horizontalDeviation	String	水平偏差趋势	是
cylinderDisplacementA	String	油缸位移A	是
cylinderDisplacementB	String	油缸位移B	是
cylinderDisplacementC	String	油缸位移C	是
cylinderDisplacementD	String	油缸位移D	是
cylinderDisplacementE	String	油缸位移E	是
cylinderDisplacementF	String	油缸位移F	是
cylinderPressureA	String	油缸压力A	是
cylinderPressureB	String	油缸压力B	是
cylinderPressureC	String	油缸压力C	是
cylinderPressureD	String	油缸压力D	是
cylinderPressureE	String	油缸压力E	是
cylinderPressureF	String	油缸压力F	是
leftCenterGroutingPressure	float	左中注浆压力	是
leftUpGroutingPressure	float	左上注浆压力	是
leftBelowGroutingPressure	float	左下注浆压力	是
rightCenterGroutingPressure	float	右中注浆压力	是
rightUpGroutingPressure	float	右上注浆压力	是
rightBelowGroutingPressure	float	右下注浆压力	是

响应结果：

成功：


xxxxxxxxxx
{
  "success": true,
  "message": "操作成功！",
  "code": 200,
  "result": null,
  "timestamp": "1681814472197"
}

平台--->第三方系统接口

塔吊（HTTP主动推送）

1、发送塔机设备数据

接口描述：	发送塔机设备数据
请求URL:	/saveTowerDev
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	说明	参数类型	是否必须	类型	schema
projectSn	项目sn	body	false	string
tower	塔吊	body	false	Tower实体类	Tower实体类

Tower实体类

参数名称	说明	参数类型	是否必须	类型
addTime	接收创建时间	body	false	string
angleSet	配置角度功能 0:未配置 1:已配置	body	false	int32
anticollision	是否防碰撞，0否，1是	body	false	int32
coordinateX	坐标X	body	false	string
createDataType	是否创建数据，0否，1是	body	false	int32
demolitionUnit	拆除单位	body	false	string
devModel	设备型号	body	false	string
devName	设备名称	body	false	string
devOnline	设置是否在线，1在线，0离线	body	false	int32
devSn	设备编号	body	false	string
driverList	司机列表	body	false	array
enableVideoUrl	是否启用视频url,1不启用，2启用	body	false	int32
factoryName	生产厂家（制造单位）	body	false	string
factoryTime	出产日期	body	false	string
forbidEntryFunExist	配置禁入区功能 0:未配置 1:已配置	body	false	int32
forbidSuspend2FunExist	配置禁吊区A类功能 0:未配置 1:已配置	body	false	int32
forbidSuspend4FunExist	配置禁吊区B类功能 0:未配置 1:已配置	body	false	int32
forearmLength	前臂长	body	false	double
generalContractorsId	总承包单位企业ID	body	false	int32
generalContractorsName	总承包单位企业名称	body	false	string
gpsSet	配置GPS功能 0:未配置 1:已配置	body	false	int32
heightSet	配置高度功能 0:未配置 1:已配置	body	false	int32
id	id	body	false	int64
idSet	配置人员识别功能 0:未配置 1:已配置	body	false	int32
importantAlarmPushWorkerId	重要报警推送人，多个逗号分割	body	false	string
installationImage	安装图片	body	false	string
installationTime	安装时间	body	false	string
installationUnit	安装单位	body	false	string
installationUnitCode	安装单位代码	body	false	string
latitude	纬度	body	false	int32
leaseUnit	出租单位	body	false	string
longtitude	经度	body	false	int32
mapX	地图X坐标	body	false	string
mapY	地图Y坐标	body	false	string
maxAngle	最大角度	body	false	string
maxHeight	最大高度	body	false	string
maxLiftingCapacity	最大起重重量	body	false	string
maxLiftingMoment	最大起重力矩	body	false	string
maxScope	最大幅度	body	false	string
minAngle	最小角度	body	false	string
minScope	最小幅度	body	false	string
multiNo	本机的多机防撞组网序号	body	false	int32
multiple	倍数	body	false	string
nodeCount	塔节数量	body	false	int32
nutHostId	螺母主机编号	body	false	string
obliguitySet	配置倾角功能 0:未配置 1:已配置	body	false	int32
posteriorArmLength	后臂长	body	false	double
projectSn	项目sn	body	false	string
promptAlarmPushWorkerId	提示告警推送人，多个逗号分割	body	false	string
propertyNumber	产权编号	body	false	string
propertyUnit	产权单位	body	false	string
rangeSet	配置幅度功能 0:未配置 1:已配置	body	false	int32
ratedObliguity	额定倾角	body	false	string
ratedWindLevel	额定风级 0~12级	body	false	string
ratedWindSpeed	额定风速 m/s	body	false	string
realTime	接收实时数据时间，30分钟没接收到实时数据表示设备离线	body	false	date-time
referenceHeight	塔顶高度(m)	body	false	double
registNo	塔吊备案号	body	false	string
registrationCertificate	登记证书照片	body	false	string
relatedX	相对坐标X	body	false	string
relatedY	相对坐标Y	body	false	string
secondaryAlarmPushWorkerId	次要报警推送人，多个逗号分割	body	false	string
standardHigh	标准高	body	false	string
structureType	结构类型，1尖头塔，2平头塔，3动臂塔	body	false	int32
superintendNo	设备备案监督编号	body	false	string
tckwWireRopeId	钢丝绳设备id	body	false	int64
testCertificate	检测证书照片	body	false	string
testNumber	检测编号	body	false	string
testQualifiedTime	检测合格时间	body	false	string
testingOrganization	检测机构	body	false	string
towerDriverList	司机列表	body	false	array
towerHeight	塔身高度	body	false	double
towerState	设备状态，1设备进场，2设备安装，3设备验收，4设备使用，5设备拆除，6设备退场	body	false	int32
towerVisualize	塔吊可视化数据	body	false	TowerVisualize实体类
urgentAlarmPushWorkerId	紧急报警推送人，多个逗号分割	body	false	string
useRegistrationNumber	使用登记办理编号	body	false	string
useRegistrationTime	使用登记时间	body	false	string
verifyCode	设备标识码	body	false	string
videoList	视频列表	body	false	array
videoUrl	视频Url	body	false	string
weightSet	配置载重功能 0:未配置 1:已配置	body	false	int32
windSpeedSet	配置风速功能 0:未配置 1:已配置	body	false	int32
workingHoursJudge	工作时长判定时间(min)	body	false	int32

BigDeviceDriverRecord实体类

参数名称	说明	参数类型	是否必须	类型
age	年龄	body	false	int32
certificateNumber	特种资格证书编号	body	false	string
continuousWorkingTime	本次连续工作时长（分钟）	body	false	int32
devSn	设备位移标识	body	false	string
driverIdCard	驾驶员身份证号	body	false	string
driverName	驾驶员姓名	body	false	string
driverPhone	驾驶员手机号	body	false	string
id	id	body	false	int64
imageUrl	照片	body	false	string
projectSn	项目sn	body	false	string
sex	性别，1男，2女	body	false	int32
type	类型，1塔吊，2升降机,3龙门吊	body	false	int32
workYear	工作年限	body	false	int32
workerId	劳务人员Id	body	false	int64

TowerVisalize实体类

参数名称	说明	参数类型	是否必须	类型
brandId	品牌ID	body	false	int64
factoryId	厂家ID	body	false	int64
id	id	body	false	int64
mastSection	标准节	body	false	int32
projectSn	项目sn	body	false	string
towerSn	塔吊设备sn	body	false	string
visualizeData	可视化数据	body	false	object

BigDeviceVideo实体类

参数名称	说明	参数类型	是否必须	类型
devSn	设备编号	body	false	string
id	id	body	false	int64
projectSn	项目sn	body	false	string
type	类型，1塔吊，2升降机,3标养室,4龙门吊,5扬尘	body	false	int32
videoItemId	视频ID	body	false	int64
videoName	视频名称	body	false	string

请求示例：


xxxxxxxxxx
{
  "projectSn": "a2ef0238b59146aa814b93f47710dbf2",
  "tower": {
    "propertyUnit": "1",
    "createDataType": 1,
    "devModel": "1",
    "forbidSuspend2FunExist": 0,
    "enableVideoUrl": 1,
    "devOnline": 1,
    "registNo": "",
    "multiNo": -1,
    "weightSet": 0,
    "driverList": [],
    "testQualifiedTime": "2021-05-10T16:00:00.000Z",
    "forbidEntryFunExist": 0,
    "maxLiftingCapacity": "1.0",
    "referenceHeight": 20,
    "forbidSuspend4FunExist": 0,
    "id": 30,
    "useRegistrationTime": "2021-05-02T16:00:00.000Z",
    "forearmLength": 5,
    "secondaryAlarmPushWorkerId": "",
    "posteriorArmLength": 11,
    "promptAlarmPushWorkerId": "",
    "factoryName": "1",
    "devName": "test",
    "angleSet": 0,
    "anticollision": 0,
    "installationImage": "",
    "idSet": 0,
    "urgentAlarmPushWorkerId": "",
    "ratedWindSpeed": "111",
    "testCertificate": "",
    "installationUnit": "1",
    "registrationCertificate": "",
    "windSpeedSet": 0,
    "installationTime": "2021-09-08T16:00:00.000Z",
    "towerState": 1,
    "towerVisualize": {},
    "mapY": "404",
    "mapX": "493",
    "towerHeight": 50,
    "maxLiftingMoment": "1.0",
    "videoUrl": "",
    "videoList": [],
    "testingOrganization": "1",
    "devSn": "55C8115AC08D4CF5BCA3983EFD9D29AE",
    "superintendNo": "513232",
    "factoryTime": "2021-09-07T16:00:00.000Z",
    "obliguitySet": 0,
    "multiple": "3",
    "towerDriverList": [],
    "importantAlarmPushWorkerId": "",
    "coordinateX": "342",
    "rangeSet": 0,
    "gpsSet": 0,
    "projectSn": "a2ef0238b59146aa814b93f47710dbf2",
    "relatedY": "33",
    "relatedX": "120",
    "heightSet": 0
  }
}

2、转发塔机实时数据

接口描述：	转发塔机实时数据
请求URL:	/saveTowerCurrentData
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	说明	参数类型	是否必须	类型	schema
projectSn	项目sn	body	false	string
tower	塔吊设备	body	false	Tower实体类	Tower实体类（参考1）
towerCurrentData	塔机实时数据	body	false	TowerCurrentData实体类	TowerCurrentData实体类

TowerCurrentData实体类

参数名称	说明	参数类型	是否必须	类型	schema
angle	角度必传参数	body	false	string
angleDirection	回转状态 0:停止回转 1:向右回转 2:向左回转	body	false	int32
angleError	角度传感器故障 0:无故障 1:有故障	body	false	int32
collideDevList	碰撞报警设备列表	body	false	array	TowerCollideVo实体类
devName	设备名称	body	false	string
devSn	设备编号	body	false	string
driverIdCard	司机身份证号	body	false	string
driverName	司机姓名	body	false	string
forbidEntryAlarm	禁入区报警 0:正常 1:报警	body	false	int32
forbidEntryNegAlarm	禁入区左转报警 0:正常 1:报警	body	false	int32
forbidEntryPosAlarm	禁入区右转报警 0:正常 1:报警	body	false	int32
forbidSuspend2Alarm	A类禁吊区域报警 0:正常 1~5:1~5区域报警	body	false	int32
forbidSuspend2NegAlarm	A类禁吊区左转报警 0:正常 1:报警	body	false	int32
forbidSuspend2OutAlarm	A类禁吊区向外变幅报警 0:正常 1:报警	body	false	int32
forbidSuspend2PosAlarm	A类禁吊区右转报警 0:正常 1:报警	body	false	int32
forbidSuspend4Alarm	B类禁吊区域报警 0:正常 1~5:1~5区域报警	body	false	int32
forbidSuspend4BackAlarm	B类禁吊区向内变幅报警 0:正常 1:报警	body	false	int32
forbidSuspend4NegAlarm	B类禁吊区左转报警 0:正常 1:报警	body	false	int32
forbidSuspend4OutAlarm	B类禁吊区向外变幅报警 0:正常 1:报警	body	false	int32
forbidSuspend4PosAlarm	B类禁吊区右转报警 0:正常 1:报警	body	false	int32
gpsError	GPS故障 0:无故障 1:有故障	body	false	int32
height	高度必传参数	body	false	string
heightAlarm	高度上限位报警 0:正常 1:报警2:预警	body	false	int32
heightDirection	起升状态 0:停止升降 1:向下落勾 2:向上起勾	body	false	int32
heightError	高度传感器故障 0:无故障 1:有故障	body	false	int32
heightLowerAlarm	高度下限位报警 0: 正常 1:报警 2:预警	body	false	int32
id	id	body	false	int64
idError	身份识别模块故障 0:无故障 1:有故障	body	false	int32
loadRatio	载重比	body	false	string
loading	载重 ,单位kg	body	false	string
maxRangeAlarm	幅度外限位报警 0:正常 1:报警2:预警	body	false	int32
minRangeAlarm	幅度内限位报警 0:正常 1:报警2:预警	body	false	int32
momentAlarm	力矩报警 0:正常 1:报警2:预警	body	false	int32
multiAlarmAll	多机防撞报警 0:正常 1:报警	body	false	int32
multiBackAlarm	多机防撞向内变幅报警 0:正常 1:报警	body	false	int32
multiNegAlarm	多机防撞左转报警 0:正常 1:报警	body	false	int32
multiNo	多机防撞组网序号	body	false	int32
multiOutAlarm	多机防撞向外变幅报警 0:正常 1:报警	body	false	int32
multiPosAlarm	多机防撞右转报警 0:正常 1:报警	body	false	int32
negAngleAlarm	逆时针回转限位报警 0:正常 1:报警2:预警	body	false	int32
noAlarm	无任何报警 0:有报警 1无任何报警	body	false	int32
noError	无任何外设故障 0:有外设故障 1无任何外设故障	body	false	int32
obliguity	倾角	body	false	string
obliguityAlarm	倾角报警 0:正常 1:报警2:预警	body	false	int32
obliguityError	倾角传感器故障 0:无故障 1:有故障	body	false	int32
obliguityX	倾角X	body	false	string
obliguityXAlarm	倾角X报警 0:正常 1:报警 2:预警	body	false	int32
obliguityY	倾角Y	body	false	string
obliguityYAlarm	倾角Y报警 0:正常 1:报警 2:预警	body	false	int32
posAngleAlarm	顺时针回转限位报警 0:正常 1:报警2:预警	body	false	int32
projectSn	项目sn	body	false	string
rangeDirection	变幅状态 0:停止变幅 1:向外变幅 2:向内变幅	body	false	int32
rangeError	幅度传感器故障 0:无故障 1:有故障	body	false	int32
ranger	幅度必传参数	body	false	string
rate	倍率必传参数	body	false	string
realFlag	实时标志 0：历史数据 1：实时数据	body	false	string
reciveTime	reciveTime	body	false	string
startTime	运行时间	body	false	string
torque	力矩	body	false	string
torqueRatio	力矩比	body	false	string
weightError	载重传感器故障 0:无故障 1:有故障	body	false	int32
windSpeedAlarm	风速报警 0:正常 1:报警2:预警	body	false	int32
windSpeedError	风速传感器故障 0:无故障 1:有故障	body	false	int32
windspeed	风速(m/s)	body	false	string

TowerCollideVo实体类

参数名称	说明	参数类型	是否必须	类型	schema
collideDevSn	碰撞设备	body	false	string
multiNo	多机防撞组网序号	body	false	int32

请求示例：


xxxxxxxxxx
{
  "towerCurrentData": {
    "devSn": "55C8115AC08D4CF5BCA3983EFD9D29AE",
    "ranger": "1.00",
    "torque": "1.00",
    "devName": "test",
    "loading": "1.00",
    "multiNo": -1,
    "noAlarm": 1,
    "obliguityY": "1.00",
    "rate": "1.00",
    "obliguityX": "1.00",
    "angle": "1.00",
    "windspeed": "1.00",
    "id": 1681227615154471000,
    "reciveTime": "2021-03-08 09:23:08",
    "projectSn": "a2ef0238b59146aa814b93f47710dbf2",
    "noError": 1,
    "height": "1.00",
    "obliguity": "1.00"
  },
  "projectSn": "a2ef0238b59146aa814b93f47710dbf2",
  "tower": {
    "propertyUnit": "1",
    "createDataType": 1,
    "devModel": "1",
    "forbidSuspend2FunExist": 0,
    "enableVideoUrl": 1,
    "registNo": "",
    "multiNo": -1,
    "weightSet": 0,
    "testQualifiedTime": "2021-05-10T16:00:00.000Z",
    "forbidEntryFunExist": 0,
    "maxLiftingCapacity": "1.0",
    "referenceHeight": 20,
    "forbidSuspend4FunExist": 0,
    "id": 30,
    "useRegistrationTime": "2021-05-02T16:00:00.000Z",
    "forearmLength": 5,
    "secondaryAlarmPushWorkerId": "",
    "posteriorArmLength": 11,
    "promptAlarmPushWorkerId": "",
    "factoryName": "1",
    "devName": "test",
    "angleSet": 0,
    "anticollision": 0,
    "installationImage": "",
    "realTime": 1689670868000,
    "idSet": 0,
    "urgentAlarmPushWorkerId": "",
    "ratedWindSpeed": "111",
    "testCertificate": "",
    "installationUnit": "1",
    "registrationCertificate": "",
    "windSpeedSet": 0,
    "installationTime": "2021-09-08T16:00:00.000Z",
    "towerState": 1,
    "mapY": "404",
    "mapX": "493",
    "towerHeight": 50,
    "maxLiftingMoment": "1.0",
    "videoUrl": "",
    "ratedWindLevel": "0",
    "testingOrganization": "1",
    "devSn": "55C8115AC08D4CF5BCA3983EFD9D29AE",
    "superintendNo": "513232",
    "factoryTime": "2021-09-07T16:00:00.000Z",
    "obliguitySet": 0,
    "multiple": "3",
    "importantAlarmPushWorkerId": "",
    "coordinateX": "342",
    "rangeSet": 0,
    "gpsSet": 0,
    "projectSn": "a2ef0238b59146aa814b93f47710dbf2",
    "relatedY": "33",
    "relatedX": "120",
    "heightSet": 0
  }
}

视频监控（HTTP主动推送）

1、发送视频监控配置数据

接口描述：	发送视频监控配置数据
请求URL:	/saveVideo
请求方式:	POST
Content-Type：	application/json

调用下面接口就会触发“发送视频监控配置数据”功能：
请求URL：xmgl/videoItem/sendVideoInfo
请求方式：POST
请求类型：application/json
请求内容：{"projectSn":"xxx"}

请求参数：

参数名称	说明	参数类型	是否必须	类型	schema
projectVideoConfig	视频配置	body	false	ProjectVideoConfig实体类	ProjectVideoConfig实体类
projectSn	项目sn	body	false	string
videoList	监控配置列表	body	false	VideoItem实体类	VideoItem实体类

ProjectVideoConfig实体类

参数名称	说明	参数类型	是否必须	类型
account	视频服务器ip（视频平台账号）	body	false	string
appId	视频平台AppId	body	false	string
appSecret	视频平台appSecret	body	false	string
id	id	body	false	int64
isEnable	是否启用，1是，0否	body	false	int32
password	视频服务器端口号（视频平台密码）	body	false	string
playType	播放方式，1高清RTMP,2流畅RTMP,3高清HLS,4流畅HLS,5高清轻量级插件，6流畅轻量级插件	body	false	int32
projectSn	项目sn	body	false	string
videoType	视频类型，1萤石云，2乐橙，3ISC，4大华，5宇视，6国标	body	false	int32

VideoItem实体类

参数名称	说明	参数类型	是否必须	类型	schema
aiFunctionType	是否具有AI识别功能 0否，1是	body	false	int32
alarmCount	报警总数	body	false	int32
alarmData	ai报警数据	body	false	array	AiAnalyseHardWareAlarmRecord实体类
alarmPushWorkerId	视频事件报警推送人	body	false	string
channelId	通道号	body	false	int32
coverUrl	封面路径	body	false	string
createTime	添加时间	body	false	date-time
deviceState	设备状态，1在线，2离线	body	false	int32
deviceType	设备类型，1 枪机，2球机，3热成像，4单兵，5全景，6无人机	body	false	int32
groupId	分组Id'	body	false	int64
ip	设备ip	body	false	string
itemId	itemId	body	false	int64
latitude		body	false	string
liveRadioUrl	直播url	body	false	string
longitude		body	false	string
mapX	地图X坐标	body	false	string
mapY	地图Y坐标	body	false	string
monitoringPointCode	云联万物-监控点编号	body	false	string
monitoringPointLocation	云联万物-监控点位置（JKDWZ001：作业面，JKDWZ002：料场，JKDWZ003：车辆出入口，JKDWZ004：人员出入口，JKDWZ005：洗轮机，JKDWZ006：围墙，JKDWZ007：塔吊，JKDWZ008：其他）	body	false	string
nvr	nvr设备	body	false	视频nvr设备	视频nvr设备
nvrDeviceState	nvr设备状态	body	false	int32
nvrId	nvr设备id	body	false	int64
nvrSn	nvr设备编号	body	false	string
projectSn	项目sn	body	false	string
serialNumber	视频设备序列号	body	false	string
sortNum	排序	body	false	int32
verificationCode	视频设备验证码	body	false	string
videoId	视频所属配置id	body	false	int64
videoName	视频设备名称	body	false	string
videoType	视频类型，1萤石云，2乐橙，3ISC，4大华，5宇视，6国标	body	false	int32

请求示例：


xxxxxxxxxx
{
  "videoList": [
    {
      "deviceType": 1,
      "nvrId": "",
      "nvrSn": "",
      "serialNumber": "xxx",
      "alarmPushWorkerId": "",
      "aiFunctionType": 0,
      "groupId": "1",
      "ip": "",
      "latitude": "",
      "videoId": "32",
      "mapY": "0",
      "verificationCode": "",
      "mapX": "0",
      "coverUrl": "",
      "itemId": "1668527441632817153",
      "monitoringPointCode": "",
      "createTime": 1686642916000,
      "liveRadioUrl": "",
      "videoName": "全景A",
      "sortNum": 0,
      "monitoringPointLocation": "",
      "deviceState": 2,
      "channelId": "",
      "longitude": ""
    }
  ],
  "projectSn": "a2ef0238b59146aa814b93f47710dbf2",
  "projectVideoConfig": {
    "videoType": 3,
    "isEnable": 1,
    "password": "18443",
    "playType": 6,
    "appId": "123456",
    "appSecret": "xxx",
    "id": 32,
    "projectSn": "a2ef0238b59146aa814b93f47710dbf2",
    "account": "182.101.141.23"
  }
}

实名制系统对接（HTTP主动推送）

劳务公司企业（HTTP主动推送）

1、保存劳务公司企业数据

接口描述：	保存劳务公司企业数据
请求URL:	/saveEnterpriseInfo
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	参数说明	请求类型	是否必须	数据类型
id	企业id	body	true	integer(int64)
projectSn	项目Sn	body	true	string
enterpriseName	企业名称	body	true	string
enterpriseLegalPerson	法定代表人	body	true	string
socialCode	社会统一信用代码	body	true	string
enterpriseTypeId	企业类型Id（1专业分包、2设备分包、3材料分包、4后勤服务、5特殊设备、6劳务分包、7监理单位、8建设单位、9总承包单位、10勘查单位、11设计单位、12其它）	body	false	integer(int64)
bankcardnumber	银行卡号	body	false	string
bankcode	银行代码	body	false	string
bankname	开户行	body	false	string
businessLicenseEndDate	营业执照截止日期	body	false	string
businessLicenseUrl	营业执照图片地址	body	false	string
businessNumber	营业执照注册号	body	false	string
departmentType	是否是项目部公司，1否，2是	body	false	integer(int32)
description	描述	body	false	string
enterpriseAddress	企业地址	body	false	string
enterpriseEmail	企业邮箱	body	false	string
enterpriseProperty	单位性质 1.国有企业 2三资企业 3集体企业 4私营企业	body	false	integer(int32)
enterpriseQualificationUrl	企业资质图片地址	body	false	string
enterpriseSafeAllow	企业安全生产许可证	body	false	string
enterpriseSn	企业sn	body	false	string
enterpriseTypeName	企业类型名称	body	false	string
legalPersonIdCard	法定人证件号	body	false	string
legalPersonTel	法人电话	body	false	string
logo	logo	body	false	string
parentEnterpriseId	父级企业ID	body	false	integer(int64)
projectDirectorName	项目负责人	body	false	string
projectDirectorPhone	项目负责人电话	body	false	string
qualificationNumber	资质证书号	body	false	string
registDate	企业注册日期	body	false	string
registerPersonName	注册人姓名	body	false	string
registerPersonPhoneTel	注册人电话	body	false	string
registeredCapital	注册资金	body	false	string
sortNum	排序	body	false	integer(int32)

请求示例：


xxxxxxxxxx
{
  "bankcardnumber": "",
  "bankcode": "",
  "bankname": "",
  "businessLicenseEndDate": "",
  "businessLicenseUrl": "",
  "businessNumber": "",
  "departmentType": 1,
  "description": "",
  "enterpriseAddress": "",
  "enterpriseEmail": "",
  "enterpriseLegalPerson": "123123",
  "enterpriseName": "12323",
  "enterpriseQualificationUrl": "",
  "enterpriseSafeAllow": "",
  "enterpriseSn": "83528ADE784C4D2CB0392F5C526861DE",
  "enterpriseTypeId": 1,
  "enterpriseTypeName": "专业分包",
  "id": 1701149512503664600,
  "legalPersonIdCard": "",
  "legalPersonTel": "",
  "logo": "",
  "parentEnterpriseId": 0,
  "projectDirectorName": "",
  "projectDirectorPhone": "",
  "projectSn": "B717CB992D054A878FDAFB4A5C169947",
  "qualificationNumber": "",
  "registDate": "",
  "registerPersonName": "",
  "registerPersonPhoneTel": "",
  "registeredCapital": "",
  "socialCode": "91320507MA21XXFU2A",
  "sortNum": 0
}

2、删除劳务公司企业数据

接口描述：	删除劳务公司企业数据
请求URL:	/removeEnterpriseInfo
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	参数说明	请求类型	是否必须	数据类型
enterpriseId	企业id	body	true	integer(int64)
projectSn	项目Sn	body	true	string

请求示例：


xxxxxxxxxx
{
  "enterpriseId": 1701149512503664600,
  "projectSn": "B717CB992D054A878FDAFB4A5C169947"
}

班组（HTTP主动推送）

1、保存班组数据

接口描述：	保存班组数据
请求URL:	/saveTeamInfo
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	参数说明	请求类型	是否必须	数据类型
id	班组id（唯一）	body	true	integer(int64)
projectSn	项目sn	body	true	string
enterpriseId	所属企业id	body	true	integer(int64)
teamName	班组名称	body	true	string
describeValue	描述	body	false	string
leaderIdCard	负责人身份证号	body	false	string
leaderName	负责人姓名	body	false	string
leaderPhone	负责人手机号	body	false	string
teamSn	班组唯一标识	body	false	string
teamType	班组类型	body	false	string

请求示例：


xxxxxxxxxx
{
  "describeValue": "",
  "enterpriseId": 1679752166673473500,
  "id": 1701184913587077000,
  "lastUpdateTime": 1694429064000,
  "leaderIdCard": "320324199001254225",
  "leaderName": "1",
  "leaderPhone": "13231111111",
  "projectSn": "B717CB992D054A878FDAFB4A5C169947",
  "specialTeam": 0,
  "teamName": "其他工种-1",
  "teamSn": "6D6B83C4560B49D19E3D50B51FA8E4DC",
  "teamType": "普通班组",
  "workerNum": 0,
  "workerTypeId": 1679701433299230700
}

2、删除班组数据

接口描述：	删除班组数据
请求URL:	/removeTeamInfo
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	参数说明	请求类型	是否必须	数据类型
id	班组id（唯一）	body	true	integer(int64)

请求示例：


xxxxxxxxxx
{
  "id": 1701184913587077000
}

部门（HTTP主动推送）

1、保存部门数据

接口描述：	保存部门数据
请求URL:	/saveDepartmentInfo
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	参数说明	请求类型	是否必须	数据类型
id	id	body	true	integer(int64)
enterpriseId	所属企业id	body	true	integer(int64)
departmentName	部门名称	body	true	string
projectSn	项目Sn	body	true	string
chargePersonIdcard	负责人身份证	body	false	string
chargePersonName	负责人姓名	body	false	string
chargePersonPhone	负责人电话	body	false	string

请求示例：


xxxxxxxxxx
{
    "departmentName": "123132",
    "enterpriseId": 1701149512503664641,
    "id": 1701438665120313346,
    "projectSn": "B717CB992D054A878FDAFB4A5C169947"
}

2、删除部门数据

接口描述：	删除部门数据
请求URL:	/removeDepartmentInfo
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	参数说明	请求类型	是否必须	数据类型
id	部门id（唯一）	body	true	integer(int64)

请求示例：


xxxxxxxxxx
{
  "id": 1701184913587077000
}

人员（HTTP主动推送）

1、保存人员数据

接口描述：	保存人员数据
请求URL:	/saveWorkerInfo
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	参数说明	请求类型	是否必须	数据类型
id	人员id	body	true	integer(int64)
personType	人员类型 1、劳务人员 2、管理人员，3临时人员	body	true	integer(int32)
idCard	身份证号	body	true	string
workerName	姓名	body	true	string
projectSn	项目sn	body	true	string
locationCardno	定位标签号	body	true	string
enterpriseId	所属企业表外键ID（personType=1或2的时候有值）	body	false	integer(int64)
teamId	班组ID（personType=1的时候有值）	body	false	integer(int64)
departmentId	部门ID（personType=2的时候有值）	body	false	integer(int64)
addTime	添加时间	body	false	string(date-time)
attendanceNumber	考勤考号	body	false	string
birthday	出生日期	body	false	string
blood	血型	body	false	string
contractImage	合同	body	false	string
emergentPerson	紧急联系人	body	false	string
emergentPhone	紧急联系电话	body	false	string
employmentCard	从业资格证书	body	false	string
enterDate	进场日期	body	false	string
examinationImage	体检报告	body	false	string
exitDate	退场时间	body	false	string
fieldAcquisitionUrl	现场采集照片	body	false	string
idCardBigPhotoUrl	身份证头像	body	false	string
idCardDownPhotoUrl	身份证反面照url	body	false	string
idCardEndDate	身份证截止日期	body	false	string
idCardUpPhotoUrl	身份证正面照url	body	false	string
inserviceType	在职状态 1在职 2离职	body	false	integer(int32)
isUploadHousing	是否上传住建，0否，1是	body	false	integer(int32)
issuingAuthorityForIdcard	身份证签发机关	body	false	string
jobName	职务	body	false	string
jobType	职务类型	body	false	string
longTerm	身份证有效期是否长期，0否，1是	body	false	integer(int32)
marry	婚否 1未婚 2已婚 3离异 4丧偶	body	false	integer(int32)
nation	民族	body	false	string
nativePlace	籍贯	body	false	string
nowPlace	现在住址	body	false	string
payRollBankName	工人工资卡银行开户行名称	body	false	string
payRollBankNumber	工人银行卡号	body	false	string
personMail	邮箱	body	false	string
personSn	personSn	body	false	string
phoneNumber	手机号	body	false	string
politicsStatus	政治面貌：1.中共党员 2.共青团团员 3.普通居民 4.其他党派人士	body	false	integer(int32)
ruleId	考勤规则ID	body	false	integer(int64)
sex	性别，1男，2女	body	false	integer(int32)
specialCertificateNumber	特殊证书号	body	false	string
specialCertificateType	特殊证书类型，1一级，2二级，3三级	body	false	integer(int32)
specialCertificateValidityTime	特殊证书有效时间	body	false	string
ufaceDevId	人脸设备表ID	body	false	string

请求示例：

劳务人员示例：


xxxxxxxxxx
{
  "attendanceNumber": "320324199001254225",
  "birthday": "1990-01-25",
  "blood": "",
  "codeState": 0,
  "contractImage": "",
  "educational": "",
  "emergentPerson": "13111111111",
  "emergentPhone": "13111111111",
  "employmentCard": "",
  "enterDate": "2023-09-21",
  "enterpriseId": 1701149512503664600,
  "examinationImage": "",
  "exitDate": "",
  "fieldAcquisitionUrl": "64ffbf55f807f92b36d87a2f.jpg",
  "id": 1701412812537753600,
  "idCard": "320324199001254225",
  "idCardBigPhotoUrl": "64ffbebf6d1e8f67738b883e.jpg",
  "idCardDownPhotoUrl": "64ffbf5df807f92b36d87a31.png",
  "idCardEndDate": "2023-09-22",
  "idCardUpPhotoUrl": "64ffbf5af807f92b36d87a30.png",
  "inserviceType": 1,
  "isUploadHousing": 0,
  "issuingAuthorityForIdcard": "发",
  "jobName": "",
  "jobType": "",
  "longTerm": 0,
  "nadCode": 0,
  "nadTime": "",
  "nation": "汉族",
  "nativePlace": "发",
  "nowPlace": "",
  "payRollBankName": "",
  "payRollBankNumber": "",
  "personMail": "",
  "personSerial": "",
  "personSn": "EB1D6664C51F4627A33BFFAB7B92ACE2",
  "personType": 1,
  "phoneNumber": "13111111111",
  "projectSn": "B717CB992D054A878FDAFB4A5C169947",
  "ruleId": 1680102550273253400,
  "sex": 2,
  "specialCertificateNumber": "",
  "specialCertificateValidityTime": "",
  "teamId": 1701407047152332800,
  "ufaceDevId": "",
  "workerClassify": 1,
  "workerName": "姓名"
}

管理人员示例：


xxxxxxxxxx
{
    "addTime": 1694489661928,
    "attendanceNumber": "320324199001254225",
    "birthday": "1990-01-25",
    "contractImage": "",
    "departmentId": 1701438665120313346,
    "educational": "",
    "emergentPerson": "fsd",
    "emergentPhone": "13132323111",
    "enterDate": "2023-09-20",
    "enterpriseId": 1701149512503664641,
    "fieldAcquisitionUrl": "64ffdc26f807f92b36d87a33.jpg",
    "id": 1701439077428785154,
    "idCard": "320324199001254225",
    "idCardBigPhotoUrl": "64ffdc22f807f92b36d87a32.jpg",
    "idCardDownPhotoUrl": "64ffdc2bf807f92b36d87a35.png",
    "idCardEndDate": "2023-09-26",
    "idCardUpPhotoUrl": "64ffdc28f807f92b36d87a34.png",
    "inserviceType": 1,
    "issuingAuthorityForIdcard": "ff",
    "jobName": "29",
    "jobType": "1",
    "longTerm": 0,
    "nation": "蒙古族",
    "nativePlace": "f",
    "personMail": "",
    "personSerial": "",
    "personSn": "EE8D683735944C31B5E4208F109B0CF9",
    "personType": 2,
    "phoneNumber": "13231111111",
    "projectSn": "B717CB992D054A878FDAFB4A5C169947",
    "ruleId": 1680102550273253377,
    "sex": 2,
    "ufaceDevId": "",
    "workerName": "信息"
}

临时人员示例：


xxxxxxxxxx
{
    "addTime": 1694489782675,
    "attendanceNumber": "1312312",
    "birthday": "1990-01-25",
    "id": 1701439583882604546,
    "idCard": "320324199001254227",
    "idCardBigPhotoUrl": "64ffdca6f807f92b36d87a36.jpg",
    "idCardEndDate": "",
    "inserviceType": 1,
    "issuingAuthorityForIdcard": "",
    "nation": "",
    "nativePlace": "",
    "personSn": "527EEEE6391F4C2BA275EA5AAB55AD36",
    "personType": 3,
    "phoneNumber": "",
    "projectSn": "B717CB992D054A878FDAFB4A5C169947",
    "workerName": "fsdsfs"
}

2、删除人员数据

接口描述：	删除人员数据
请求URL:	/removeWorkerInfo
请求方式:	POST
Content-Type：	application/json

请求参数：

参数名称	参数说明	请求类型	是否必须	数据类型
id	人员id	body	true	integer(int64)

请求示例：


xxxxxxxxxx
{
    "id": 1701412812537753600
}

智慧工地平台接口文档

设备厂商--->平台系统接口

扬尘对接

1、添加扬尘噪声实时数据信息

2、修改绿色扬尘设备喷淋状态

塔吊在线监测系统对接

1、添加塔吊实时数据

2、添加塔吊报警数据

3、添加塔吊循环数据

4、修改塔吊设备信息

5、添加塔吊违章数据

6、添加塔吊螺母信息

7、添加塔吊顶升记录

升降机在线监测系统对接

1、添加升降机实时数据

2、添加升降机报警数据

3、添加升降机工作循环数据

4、添加升降机违规数据

水表对接

1、上报水表实时的数据

2. 上报状态

电表对接

1.上报电表实时的数据

2. 上报状态

实名制系统对接

1 HTTP接口

1.1 基本要求：

2 劳务公司接口

2.1 获取企业类型

2.2 变更劳务公司

2.3 删除劳务公司

2.4 项目绑定劳务公司

2.5 获取劳务公司

3 班组接口

3.1 变更班组

3.2 删除班组

3.3 获取班组

4 工种接口

4.1 获取工种

5 人员接口

5.1 上传图片

5.2 变更人员(保存或修改人员数据)

5.3 删除人员

5.4 获取人员

5.5 上报通行记录

5.6 获取通行记录

5.7 添加实名认证

5.8 通过项目SN查询全部人员信息

5.9 查询劳务人员黑名单列表

6 设备接口

6.1 上传通行设备

6.2 发送通行设备心跳

考勤设备对接（dg）

1时间同步

2下载白名单（拉取允许通行人员信息）

3.考勤照片上传

4.照片质量反馈

配电箱对接

1、添加配电箱实时数据

临边防护网对接

1.新增临边防护-设备实时数据（联睿科对接）

临边防护(无网)对接

1、临边防护(无网)上传数据-（艾礼安云平台设备状态信息订阅）

联睿科-基坑数据推送标准_v1（钢结构自动化监测系统、高边坡）

1、 推送方式

2、数据格式

2.1 、必须数据

2.2 、基坑设备相关字段

3、数据示例

3.1、请求示例

4、映射表

联睿科-外墙脚手架监测数据推送标准_v1

1、 推送方式

2、数据格式

2.1 、必须数据

2.2、外墙脚手架监测设备相关字段

2.2.1、实时数据

2.2.2、静态数据

3、数据示例

高支模自动化监测对接（联睿科）

1、推送方式

1、推送方式