zcloud_gbs
/
zcloud-gbs-primeport
14
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
zcloud-gbs-primeport/api-doc.md

65 KiB
Raw Permalink Blame History

港口岸门门禁管理系统 - 前端接口文档

基础路径：${application.gateway} 运行时替换为 /primeport

COLA 通用响应结构：

响应类型 字段
Response errCode(String), errMessage(String), success(Boolean)
SingleResponse<T> errCode, errMessage, success, data(T)
MultiResponse<T> errCode, errMessage, success, data(List<T>)
PageResponse<T> errCode, errMessage, success, data(List<T>), totalCount(Long), pageSize(Integer), pageNumber(Integer)

分页查询基类字段（所有 Qry 继承）：pageSize(Integer), pageNumber(Integer)

一、门口信息管理 /${gateway}/mkmj

1.1 新增门口

  • POST /save
  • 请求体：
字段 类型 必填 说明
mkmjName String 是 口门名称
mkmjLevel Integer 是 口门级别 1-一级 2-二级
mkmjType String 是 口门类型
mkmjTypeName String 是 口门类型名称 1-人行 2-车行 3-综合
hgAuthArea String 是 所属港区
hgAuthAreaName String 是 所属港区名称
mkmjStatus Integer 是 口门状态 1-停用 2-正常
inDirectionArea Long 否 入方向区域(二级)
inDirectionAreaName String 否 入方向区域名称(二级)
outDirectionArea Long 否 出方向区域(二级)
outDirectionAreaName String 否 出方向区域名称(二级)
closedAreaId Long 否 封闭区域id(二级)
outDirectionType Integer 否 进出类型 1离场 2离开进入其他区域
longitude String 否 经度
latitude String 否 纬度
remarks String 否 口门位置
mkmjAreaJurisdictionalCorpId Long 否 管辖单位id
  • 响应：SingleResponse<MkmjCO>

MkmjCO：

字段 类型 说明
id Long 主键
mkmjName String 口门名称
hgAuthArea String 所属港区
hgAuthAreaName String 所属港区名称
mkmjLevel Integer 口门级别 1-一级 2-二级
mkmjType String 口门类型
mkmjTypeName String 口门类型名称
mkmjStatus Integer 口门状态
inDirectionArea Long 入方向区域
inDirectionAreaName String 入方向区域名称
outDirectionArea Long 出方向区域
outDirectionAreaName String 出方向区域名称
closedAreaId Long 封闭区域id
closedAreaName String 封闭区域名称
outDirectionType Integer 进出类型
longitude String 经度
latitude String 纬度
remarks String 口门位置
videoCount Integer 摄像头数量
passageCount Integer 通道数量
jurisdictionalCorpId Long 管辖单位id
mkmjAreaJurisdictionalCorpId Long 口门管辖单位id
jurisdictionalCorpName String 管辖单位名称

1.2 分页查询

  • POST /list
  • 请求体：
字段 类型 必填 说明
likeMkmjName String 否 口门名称模糊查询
mkmjStatus Integer 否 口门状态
mkmjType String 否 口门类型
mkmjLevel Integer 否 口门级别
hgAuthArea String 否 所属区域
closedAreaId Long 否 封闭区域id
  • 响应：PageResponse<MkmjCO>

1.3 分页查询(免Token)

  • POST /listNoToken
  • 请求体：同 1.2
  • 响应：PageResponse<MkmjCO>

1.4 查询所有

  • GET /listAll
  • 请求参数：同 1.2（QueryParam）
  • 响应：MultiResponse<MkmjCO>

1.5 详情

  • GET /{id}
  • 路径参数：id(Long)
  • 响应：SingleResponse<MkmjCO>

1.6 删除

  • DELETE /{id}
  • 路径参数：id(Long)
  • 响应：Response

1.7 修改

  • PUT /edit
  • 请求体：同 1.1 + id(Long, 必填)
  • 响应：SingleResponse

1.8 停用/启用

  • PUT /editStatus
  • 请求体：
字段 类型 必填 说明
id Long 是 主键
mkmjStatus Integer 是 口门状态 1-停用 2-正常
  • 响应：SingleResponse

1.9 名称唯一性校验

  • GET /check-name
  • 请求参数：
字段 类型 必填 说明
mkmjName String 是 口门名称
id Long 否 记录ID(编辑时传)
  • 响应：SingleResponse<Map<String, Boolean>> (available: true/false)

二、门禁通道 /${gateway}/mkmjPassage

2.1 新增

  • POST /save
  • 请求体：
字段 类型 必填 说明
passageName String 是 通道名称
passageType String 是 通道类型 1-人行 2-车行 3-综合
passageTypeName String 是 通道类型名称
passageStatus Integer 是 通道状态 1-停用 2-正常
mkmjId Long 是 口门区域id
longitude String 否 经度
latitude String 否 纬度
  • 响应：SingleResponse<MkmjPassageCO>

MkmjPassageCO：

字段 类型 说明
id Long 主键
passageName String 通道名称
passageType String 通道类型
passageTypeName String 通道类型名称
passageStatus Integer 通道状态
passageStatusName String 通道状态名称
mkmjId Long 口门区域id
mkmjName String 口门名称
longitude String 经度
latitude String 纬度
remarks String 备注
gateCount Integer 闸机数量
videoCount Integer 摄像头数量

2.2 分页查询

  • POST /list
  • 请求体：
字段 类型 必填 说明
eqMkmjId Long 否 口门ID
likePassageName String 否 通道名称模糊查询
eqPassageType String 否 通道类型
eqPassageStatus Integer 否 通道状态
  • 响应：PageResponse<MkmjPassageCO>

2.3 详情

  • GET /{id}
  • 响应：SingleResponse<MkmjPassageCO>

2.4 删除

  • DELETE /{id}
  • 响应：Response

2.5 修改

  • PUT /edit
  • 请求体：同 2.1 + id(Long, 必填)
  • 响应：SingleResponse

2.6 名称唯一性校验

  • GET /check-name
  • 请求参数：
字段 类型 必填 说明
passageName String 是 通道名称
mkmjId Long 是 口门ID
id Long 否 记录ID
  • 响应：SingleResponse<Map<String, Boolean>>

三、闸机管理 /${gateway}/mkmjGate

3.1 新增

  • POST /save
  • 请求体：
字段 类型 必填 说明
mkmjId Long 是 口门区域id
passageId Long 是 通道id
gateNumber String 否 闸机标识
gateName String 是 闸机名称
gateType String 是 闸机类型
gateTypeName String 是 闸机类型名称
gateStatus Integer 是 闸机状态 1-停用 2-正常
gateCategory String 是 闸机类别
gateCategoryName String 是 闸机类别名称
gateModel String 是 闸机型号
gatePosition String 是 闸机位置
longitude String 否 经度
latitude String 否 纬度
  • 响应：SingleResponse<MkmjGateCO>

MkmjGateCO：

字段 类型 说明
id Long 主键
mkmjId Long 口门区域id
mkmjName String 口门名称
passageId Long 通道id
passageName String 通道名称
gateNumber String 闸机标识
gateName String 闸机名称
gateType String 闸机类型
gateTypeName String 闸机类型名称
gateStatus Integer 闸机状态
gateStatusName String 闸机状态名称
gateCategory String 闸机类别
gateCategoryName String 闸机类别名称
gateModel String 闸机型号
gatePosition String 闸机位置
longitude String 经度
latitude String 纬度
videoCount Integer 摄像头数量

3.2 分页查询

  • POST /list
  • 请求体：
字段 类型 必填 说明
mkmjId Long 否 口门ID
passageId Long 否 通道ID
gateName String 否 闸机名称模糊查询
gateType String 否 闸机类型
gateCategory String 否 闸机类别
gateStatus Integer 否 闸机状态
  • 响应：PageResponse<MkmjGateCO>

3.3 详情

  • GET /{id}
  • 响应：SingleResponse<MkmjGateCO>

3.4 删除

  • DELETE /{id}
  • 响应：Response

3.5 修改

  • PUT /edit
  • 请求体：同 3.1 + id(Long, 必填)
  • 响应：SingleResponse

3.6 名称唯一性校验

  • GET /check-name
  • 请求参数：
字段 类型 必填 说明
gateName String 是 闸机名称
passageId Long 是 通道ID
id Long 否 记录ID
  • 响应：SingleResponse<Map<String, Boolean>>

四、口门审批人 /${gateway}/mkmjApprovalUser

4.1 新增

  • POST /save
  • 请求体：
字段 类型 必填 说明
corpId Long 是 审批人企业id
corpName String 是 审批人企业名称
deptId Long 是 审批人部门id
deptName String 是 审批人部门名称
postId Long 否 审批人岗位Id
postName String 否 审批人岗位名称
userId Long 是 审批人id
userName String 是 审批人名称
personnelPermissionFlag Integer 是 人员审核权限 1-无 2-有
vehiclePermissionFlag Integer 是 车辆审核权限 1-无 2-有
temporaryPermissionFlag Integer 是 临时审核权限 1-无 2-有
  • 响应：SingleResponse<MkmjApprovalUserCO>

MkmjApprovalUserCO：

字段 类型 说明
id Long 主键
corpId Long 企业id
corpName String 企业名称
postId Long 岗位Id
postName String 岗位名称
deptId Long 部门id
deptName String 部门名称
userId Long 审批人id
userName String 审批人名称
personnelPermissionFlag Integer 人员审核权限
vehiclePermissionFlag Integer 车辆审核权限
temporaryPermissionFlag Integer 临时审核权限

4.2 分页查询

  • POST /list
  • 请求体：
字段 类型 必填 说明
corpId Long 是 审批人企业id
deptId Long 否 审批人部门id
userName String 否 审批人姓名
personnelPermissionFlag Integer 否 人员审核权限
vehiclePermissionFlag Integer 否 车辆审核权限
temporaryPermissionFlag Integer 否 临时审核权限
needSelfCorpApprovalUserFlag Integer 否 1本租户 2所有审批人
  • 响应：PageResponse<MkmjApprovalUserCO>

4.3 查询所有

  • GET /listAll
  • 响应：MultiResponse<MkmjApprovalUserCO>

4.4 详情

  • GET /{id}
  • 响应：SingleResponse<MkmjApprovalUserCO>

4.5 删除

  • DELETE /{id}
  • 响应：Response

4.6 校验审批人是否已录入

  • GET /checkExistByUserId/{userId}
  • 路径参数：userId(Long)
  • 响应：SingleResponse<AvailableResultCO>

AvailableResultCO：

字段 类型 说明
available Boolean 是否可用
availableMessage String 不可用原因

4.7 修改

  • PUT /edit
  • 请求体：同 4.1 + id(Long, 必填)
  • 响应：SingleResponse

五、摄像头 /${gateway}/video

5.1 新增

  • POST /save
  • 请求体：
字段 类型 必填 说明
foreignId Long 是 口门/闸机id
deviceType Integer 是 设备类型 1-口门 2-闸机
videoResourceId String 是 摄像头id
videoResourceName String 是 摄像头名称
videoResourceCode String 否 摄像头编码
videoType Integer 是 摄像头类型 1-移动 2-平台
longitude String 否 经度
latitude String 否 纬度
  • 响应：SingleResponse<VideoCO>

VideoCO：

字段 类型 说明
id Long 主键
foreignId Long 口门/闸机id
deviceType Integer 设备类型
videoResourceId String 摄像头id
videoResourceName String 摄像头名称
videoResourceCode String 摄像头编码
videoType Integer 摄像头类型
longitude String 经度
latitude String 纬度
isOnline String 是否在线
type String 来源 yd移动/gd固定

5.2 分页查询

  • POST /list
  • 请求体：
字段 类型 必填 说明
eqForeignId Long 否 口门/闸机id
eqDeviceType Integer 否 设备类型
videoResourceName String 否 视频名称
eqIsOnline Integer 否 是否在线 0离线/1在线
  • 响应：PageResponse<VideoCO>

5.3 详情 / 删除 / 修改

  • GET /{id} → SingleResponse<VideoCO>
  • DELETE /{id} → Response
  • PUT /edit → SingleResponse（请求体同 5.1 + id）

六、刷卡记录 /${gateway}/mkmjSwipeCardRecord

6.1 大华对接推送(内部)

  • POST /dockSave
  • 请求体：SwipeRecordPushVo（三层嵌套，大华 EVO-AccessControl 推送）
  • 响应：SingleResponse

6.2 新增

  • POST /save
  • 请求体：MkmjSwipeCardRecordAddCmd
  • 响应：SingleResponse<MkmjSwipeCardRecordCO>

MkmjSwipeCardRecordCO 主要字段：

字段 类型 说明
id Long 主键
nodeCode String 节点编码
deviceCode String 设备编号
alarmCode String 报警编号
alarmDate Long 报警时间(10位时间戳)
alarmGrade Integer 报警等级 1严重 2一般 3轻微
alarmStat Integer 报警状态 1产生 2消失
channelName String 通道名称
acsChannelCode String 通道编号
acsChannelName String 通道名称
enterOrExit String 进出门类型
swingTime String 刷卡时间
deviceName String 设备名称
personCode String 人员编号
personId Long 人员ID(大华)
personName String 人员姓名
personImg String 人员图片路径
paperType String 证件类型
paperNumber String 证件号
openType String 开门类型
openResult Integer 开门结果 0失败 1成功
openFailedCod String 开门错误码
cardNumber String 卡号
cardType Integer 卡类型
category String 卡介质 0-IC 1-有源RFID 2-CPU
maskState Integer 口罩状态 3戴 2未戴 1未识别 0未知
sex Integer 性别 1男 2女 0未知
age Integer 年龄
deptName String 部门名称
deptId Long 部门id
orgName String 组织名称
orgCode String 组织编码
vRecordFlag Integer 访客标识 0非访客 1访客
recordImage1 String 抓拍图路径
beginTime Long 开始时间(13位时间戳)

6.3 分页查询

  • POST /list
  • 请求体：
字段 类型 必填 说明
cardNo String 否 卡号
likeDeviceName String 否 设备名称模糊查询
swingTimeStart String 否 刷卡时间起始
swingTimeEnd String 否 刷卡时间结束
  • 响应：PageResponse<MkmjSwipeCardRecordCO>

6.4 详情 / 删除 / 批量删除

  • GET /{id} → SingleResponse<MkmjSwipeCardRecordCO>
  • DELETE /{id} → Response
  • DELETE /ids?ids=1,2,3 → Response

七、封闭区域 /${gateway}/closedArea

7.1 树级结构

  • GET /listTree
  • 请求参数：
字段 类型 必填 说明
closedAreaName String 否 封闭区域名称
hgAuthArea String 否 所属港区
parentId Long 否 父节点(根节点传0)
jurisdictionalCorpId Long 否 管辖单位
  • 响应：MultiResponse<ClosedAreaCO>

ClosedAreaCO：

字段 类型 说明
id Long 主键
parentId Long 父节点id
hgAuthArea String 所属港区
hgAuthAreaName String 所属港区名称
closedAreaName String 封闭区域名称
closedAreaType String 区域类型
closedAreaTypeName String 区域类型名称
jurisdictionalCorpId Long 管辖单位id
jurisdictionalCorpName String 管辖单位名称
location String 区域经纬度
deleteEnum String 删除标记
remarks String 备注
totalAreaCount Integer 封闭区域总数
totalCorpCount Integer 管辖单位总数
hasChild Integer 1有子节点 2无子节点
children List<ClosedAreaCO> 子节点列表

7.2 统计港区封闭区域数与管辖单位数

  • GET /getCountByHgAuthArea
  • 响应：MultiResponse<ClosedAreaCO>

7.3 新增

  • POST /save
  • 请求体：
字段 类型 必填 说明
parentId Long 是 父id
hgAuthArea String 是 所属港区
hgAuthAreaName String 是 所属港区名称
closedAreaName String 是 封闭区域名称
closedAreaType String 是 区域类型
closedAreaTypeName String 是 区域类型名称
jurisdictionalCorpId Long 是 管辖单位id
jurisdictionalCorpName String 是 管辖单位名称
location String 否 区域经纬度
  • 响应：SingleResponse<ClosedAreaCO>

7.4 分页查询

  • POST /list
  • 请求体：同 7.1
  • 响应：PageResponse<ClosedAreaCO>

7.5 根据港区选择封闭区域

  • GET /listAllByhgAuthArea?hgAuthArea=xxx
  • 响应：MultiResponse<ClosedAreaCO>

7.6 根据管辖单位查询封闭区域

  • GET /listAllByJurisdictionalCorpId/{id}
  • 路径参数：id(Long) 管辖单位ID
  • 响应：MultiResponse<ClosedAreaCO>

7.7 详情 / 删除 / 批量删除 / 修改

  • GET /{id} → SingleResponse<ClosedAreaCO>
  • DELETE /{id} → Response
  • DELETE /ids?ids=1&ids=2 → Response
  • PUT /edit → SingleResponse（请求体含 id + 可选修改字段）

7.8 区域人员和车辆统计

  • POST /count
  • 请求体：
字段 类型 必填 说明
corpId Long 否 公司id
closedAreaName String 否 封闭区域名称
parentId Long 否 父节点ID
  • 响应：MultiResponse<ClosedAreaCountCO>

ClosedAreaCountCO：

字段 类型 说明
id Long 主键
parentId Long 父节点id
closedAreaName String 封闭区域名称
personCount Integer 人员现存数
carCount Integer 车辆现存数
hasChild Integer 1有子节点 2无子节点
children List<ClosedAreaCountCO> 子节点列表

八、封闭区域人员申请 /${gateway}/closedAreaPersonApply

8.1 新增

  • POST /save
  • 请求体：
字段 类型 必填 说明
personBelongType Integer 是 1股份 2分公司 3相关方 4临时人员
levelOneMkmjId Long 否 一级口门id
levelTwoMkmjId Long 否 二级口门id
closedAreaId Long 是 封闭区域id
closedAreaName String 是 封闭区域名称
visitStartTime String 是 访问起始时间
visitEndTime String 是 访问结束时间
jurisdictionalCorpId Long 是 管辖单位id
jurisdictionalCorpName String 是 管辖单位名称
projectId Long 否 项目id
projectName String 否 项目名称
applyReason String 是 申请理由
entourage String 否 随行人员(JSON)
informSignId String 是 告知签字
auditPersonCorpId Long 是 审批人企业ID
auditPersonCorpName String 是 审批人企业名称
auditPersonDepartmentId Long 是 审批人部门id
auditPersonDepartmentName String 是 审批人部门名称
auditPersonUserId Long 是 审批人id
auditPersonUserName String 是 审批人姓名
applyPersonUserName String 否 申请人姓名(临时)
userFaceUrl String 否 申请人头像(临时)
userPhone String 否 申请人手机号(临时)
userCard String 否 申请人身份证号(临时)
  • 响应：SingleResponse<ClosedAreaPersonApplyCO>

ClosedAreaPersonApplyCO：

字段 类型 说明
id Long 主键
personBelongType Integer 申请归属
levelOneMkmjId Long 一级口门id
levelTwoMkmjId Long 二级口门id
levelOneMkmjName String 一级口门名称
levelTwoMkmjName String 二级口门名称
closedAreaId Long 封闭区域id
closedAreaName String 封闭区域名称
auditFlag Integer 审核状态
mkmjPermission Integer 进出港权限 1有 2无
visitStartTime String 访问起始时间
visitEndTime String 访问结束时间
jurisdictionalCorpId Long 管辖单位id
jurisdictionalCorpName String 管辖单位名称
projectId Long 项目id
projectName String 项目名称
applyPersonCorpId Long 申请人企业ID
applyPersonCorpName String 申请人企业名称
applyPersonDepartmentId Long 申请人部门id
applyPersonDepartmentName String 申请人部门名称
applyPersonUserId Long 申请人id
applyPersonUserName String 申请人姓名
applyUserName String 申请人姓名
applyReason String 申请理由
userFaceUrl String 申请人头像
userPhone String 申请人手机号
userCard String 申请人身份证号
entourage String 随行人员
informSignId String 告知签字
auditPersonCorpId Long 审批人企业ID
auditPersonCorpName String 审批人企业名称
auditPersonDepartmentId Long 审批人部门id
auditPersonDepartmentName String 审批人部门名称
auditPersonUserId Long 审批人id
auditPersonUserName String 审批人姓名
auditTime String 审批时间
refusalReason String 驳回原因
currentUserCanAudit Integer 当前用户是否可审批
personInOutRecord List<HashMap> 进出记录
areaList List<FgsPersonArea> 授权范围

8.2 待审批/已审批/申请记录分页

  • POST /pendingApprovalRecordList
  • 请求体：
字段 类型 必填 说明
name String 否 人员搜索
deptId Long 否 按部门搜索
noSelf Integer 否 1带自己 2不带自己
applyPersonCorpName String 否 申请人公司名称
applyPersonUserName String 否 申请人名称
processOrRecord Integer 否 1本单位申请中 2本单位申请记录
personBelongType Integer 否 1股份 2分公司 3相关方 4临时
hasFaceUrl Integer 否 1有图片
projectName String 否 项目名称
  • 响应：PageResponse<ClosedAreaPersonApplyCO>

8.3 申请记录部门列表

  • GET /pendingApprovalDeptList
  • 响应：MultiResponse<ClosedAreaPersonApplyDeptCO>

8.4 审批人员申请

  • POST /auditPersonApply
  • 请求体：
字段 类型 必填 说明
id Long 是 主键
auditFlag Integer 否 2通过 3驳回
refusalReason String 否 驳回原因
  • 响应：Response

8.5 授权二级门禁

  • POST /authorizationPerson
  • 请求体：
字段 类型 必填 说明
userId Long 是 用户id
mkmjPermission Integer 是 权限 1有 2无
corpId Long 否 企业id
departmentId Long 否 部门id
areaList List<FgsPersonArea> 否 授权范围
- fgsPersonAuthId Long 否 授权id
- closedAreaId Long 否 封闭区域id
- closedAreaName String 否 封闭区域名称
  • 响应：Response

8.6 查询分公司人员授权范围

  • GET /getAuthorizationPersonInfo/{id}
  • 响应：SingleResponse<ClosedAreaPersonApplyCO>

8.7 获取本单位人员信息(用于随行人员)

  • POST /getCorpUserList
  • 请求体：同 8.2
  • 响应：PageResponse<UserCo>

UserCo：

字段 类型 说明
corpId Long 企业id
corpName String 企业名称
deptId Long 部门id
deptName String 部门名称
postId Long 岗位id
postName String 岗位名称
userId Long 用户id
name String 姓名
userName String 用户名
phone String 手机号
userFaceUrl String 头像
userIdCard String 身份证号
employmentFlag Integer 在职标志
rzFlag Integer 入职标志
vehicleCount Integer 车辆数
mkmjPermission Integer 进出港权限

8.8 详情

  • GET /{id}
  • 响应：SingleResponse<ClosedAreaPersonApplyCO>

九、封闭区域车辆申请 /${gateway}/closedAreaCarApply

9.1 新增

  • POST /save
  • 请求体：
字段 类型 必填 说明
carBelongType Integer 是 1股份 2分公司 3相关方 4临时 5分公司内部车
licenceType String 是 车牌类型
licenceTypeName String 是 车牌类型名称
licenceNo String 是 车牌号
vehicleType String 是 车辆类型
vehicleTypeName String 是 车辆类型名称
levelOneMkmjId Long 否 一级口门id
levelTwoMkmjId Long 否 二级口门id
closedAreaId Long 是 封闭区域id
closedAreaName String 否 封闭区域名称
visitStartTime String 是 访问起始时间
visitEndTime String 是 访问结束时间
jurisdictionalCorpId Long 否 管辖单位id
jurisdictionalCorpName String 否 管辖单位名称
projectId Long 否 项目id
projectName String 否 项目名称
applyReason String 是 申请理由
entourage String 否 随行人员
informSignId String 是 告知签字
drivingUserId Long 否 驾驶人ID
drivingUserName String 否 驾驶人名称
drivingLicenseId String 是 行驶证照片
attachmentId String 是 车辆照片
auditPersonCorpId Long 是 审批人企业ID
auditPersonCorpName String 是 审批人企业名称
auditPersonDepartmentId Long 是 审批人部门id
auditPersonDepartmentName String 是 审批人部门名称
auditPersonUserId Long 是 审批人id
auditPersonUserName String 是 审批人姓名
  • 响应：SingleResponse<ClosedAreaCarApplyCO>

ClosedAreaCarApplyCO：

字段 类型 说明
id Long 主键
carBelongType Integer 申请归属
licenceType String 车牌类型
licenceTypeName String 车牌类型名称
licenceNo String 车牌号
vehicleType String 车辆类型
vehicleTypeName String 车辆类型名称
levelOneMkmjId Long 一级口门id
levelTwoMkmjId Long 二级口门id
levelOneMkmjName String 一级口门名称
levelTwoMkmjName String 二级口门名称
closedAreaId Long 封闭区域id
closedAreaName String 封闭区域名称
auditFlag Integer 审核状态
visitStartTime String 访问起始时间
visitEndTime String 访问结束时间
jurisdictionalCorpId Long 管辖单位id
jurisdictionalCorpName String 管辖单位名称
projectId Long 项目id
projectName String 项目名称
applyPersonCorpId Long 申请人企业ID
applyPersonCorpName String 申请人企业名称
applyPersonDepartmentId Long 申请人部门id
applyPersonDepartmentName String 申请人部门名称
applyPersonUserId Long 申请人id
applyPersonUserName String 申请人姓名
applyUserName String 申请人姓名
applyReason String 申请理由
userFaceUrl String 申请人头像
userPhone String 申请人手机号
userCard String 申请人身份证号
entourage String 随行人员
informSignId String 告知签字
drivingLicenseId String 行驶证照片
attachmentId String 车辆照片
auditPersonCorpId Long 审批人企业ID
auditPersonCorpName String 审批人企业名称
auditPersonDepartmentId Long 审批人部门id
auditPersonDepartmentName String 审批人部门名称
auditPersonUserId Long 审批人id
auditPersonUserName String 审批人姓名
auditTime String 审批时间
refusalReason String 驳回原因
currentUserCanAudit Integer 当前用户是否可审批
personInOutRecord List<HashMap> 进出记录

9.2 分页查询

  • POST /list
  • 请求体：
字段 类型 必填 说明
licenceNo String 否 车牌号
applyPersonUserName String 否 申请人姓名
auditFlag Integer 否 审核状态
processOrRecord Integer 否 1申请中 2申请记录
carBelongType Integer 否 1股份 2分公司 3相关方 4临时
applyPersonCorpName String 否 申请人公司名称
projectName String 否 项目名称
  • 响应：PageResponse<ClosedAreaCarApplyCO>

9.3 审批车辆申请

  • POST /auditCarApply
  • 请求体：
字段 类型 必填 说明
id Long 是 主键
auditFlag Integer 否 2通过 3驳回
refusalReason String 否 驳回原因
  • 响应：Response

9.4 详情 / 删除

  • GET /{id} → SingleResponse<ClosedAreaCarApplyCO>
  • DELETE /{id} → Response

十、封闭区域临时申请 /${gateway}/closedTmpApply

10.1 新增

  • POST /save
  • 请求体：
字段 类型 必填 说明
tmpApplyType String 是 PERSON_APPLY / CAR_APPLY
tmpMkmjType String 是 一级人:ONE_LEVEL_PERSON_APPLY 二级人:TWO_LEVEL_PERSON_APPLY 一级车:ONE_LEVEL_CAR_APPLY 二级车:TWO_LEVEL_CAR_APPLY
auditPersonCorpId Long 是 审批人企业ID
auditPersonCorpName String 是 审批人企业名称
auditPersonDepartmentId Long 是 审批人部门id
auditPersonDepartmentName String 是 审批人部门名称
auditPersonUserId Long 是 审批人id
auditPersonUserName String 是 审批人姓名
applyPersonUserName String 否 申请人姓名
userFaceUrl String 否 申请人头像
userPhone String 否 申请人手机号
userCard String 否 申请人身份证号
applyReason String 是 申请理由
visitStartTime String 是 访问起始时间
visitEndTime String 是 访问结束时间
hgAuthArea String 是 所属港区
hgAuthAreaName String 是 所属港区名称
levelOneMkmjId Long 否 一级口门id
levelOneMkmjName String 是 一级口门名称
informSignId Long 是 告知签字
jurisdictionalCorpId Long 否 管辖单位id(二级人)
jurisdictionalCorpName String 否 管辖单位名称(二级人)
closedAreaId Long 否 封闭区域id(二级人)
closedAreaName String 否 封闭区域名称(二级人)
levelTwoMkmjId Long 否 二级口门id(二级人)
levelTwoMkmjName String 否 二级口门名称(二级人)
licenceType String 否 车牌类型(车)
licenceTypeName String 否 车牌类型名称(车)
licenceNo String 否 车牌号(车)
vehicleType String 否 车辆类型(车)
vehicleTypeName String 否 车辆类型名称(车)
drivingLicenseId String 否 行驶证照片(车)
attachmentId String 否 车辆照片(车)
drivingUserId String 否 驾驶人ID(车)
drivingUserName String 否 驾驶人名称(车)
  • 响应：SingleResponse<HashMap<String, Object>> (返回 id, tmpApplyType, tmpMkmjType)

10.2 详情

  • GET /getInfoById?id={id}&tmpApplyType={type}&tmpMkmjType={mkmjType}
  • 响应：SingleResponse<TmpApplyCO>

TmpApplyCO：

字段 类型 说明
id Long 主键
tmpApplyType String 申请类型
auditFlag Integer 审核状态
licenceNo String 车牌号(车)
vehicleType String 车辆类型(车)
levelOneMkmjId Long 一级口门id
levelOneMkmjName String 一级口门名称
levelTwoMkmjId Long 二级口门id
levelTwoMkmjName String 二级口门名称
closedAreaId Long 封闭区域id
closedAreaName String 封闭区域名称
visitStartTime String 访问起始时间
visitEndTime String 访问结束时间
jurisdictionalCorpId Long 管辖单位id
jurisdictionalCorpName String 管辖单位名称
applyPersonUserName String 申请人姓名
applyReason String 申请理由
userPhone String 申请人手机号
drivingLicenseId String 行驶证照片(车)
attachmentId String 车辆照片(车)
gateLevelAuthArea String 授权范围
auditPersonCorpId Long 审批人企业ID
auditPersonCorpName String 审批人企业名称
auditPersonDepartmentId Long 审批人部门id
auditPersonDepartmentName String 审批人部门名称
auditPersonUserId Long 审批人id
auditPersonUserName String 审批人姓名
auditTime String 审批时间
refusalReason String 驳回原因

十一、车辆申请 /${gateway}/vehicleApply

11.1 新增(长期车辆录入)

  • POST /save
  • 请求体：
字段 类型 必填 说明
licenceType String 是 车牌类型
licenceTypeName String 是 车牌类型名称 0白牌 1蓝牌 2黄牌 3绿牌 4黑牌
licenceNo String 是 车牌号
vehicleType String 是 车辆类型
vehicleTypeName String 是 车辆类型名称
vehicleBelongType String 是 车辆所属 1股份员工 2股份单位 3分公司员工 4分公司单位 5相关方 6临时 7检查部门
gateLevelAuthArea String 是 授权范围港区与区域
visitStartTime String 是 访问起始时间
visitEndTime String 是 访问结束时间
drivingLicenseId String 是 行驶证照片
attachmentId String 是 车辆照片
informSignId String 否 告知签字
projectId Long 否 项目id
projectName String 否 项目名称
mkmjId Long 否 口门id
mkmjName String 否 口门名称
lsUserPhone String 否 临时驾驶人手机号
lsUserIdcard String 否 临时驾驶人身份证
drivingUserId Long 否 临时驾驶人ID
drivingUserName String 否 临时驾驶人姓名
remarks String 否 来访事由
vehicleCorpId Long 否 车辆所属企业ID
vehicleCorpName String 否 车辆所属企业名称
vehicleDepartmentId Long 否 车辆所属部门id
vehicleDepartmentName String 否 车辆所属部门名称
employeeVehicleUserId Long 否 车辆所属人id
employeeVehicleUserName String 否 车辆所属人名称
auditCorpId Long 否 审核企业
auditCorpName String 否 审核企业名称
auditDeptId Long 否 审核部门
auditDeptName String 否 审核部门名称
auditUserId Long 否 审核用户
auditUserName String 否 审核用户名称
  • 响应：SingleResponse<VehicleApplyCO>

VehicleApplyCO：

字段 类型 说明
id Long 主键
statusFlag Integer 车辆状态 1未启用 2启用
licenceType String 车牌类型
licenceTypeName String 车牌类型名称
licenceNo String 车牌号
vehicleType String 车辆类型
vehicleTypeName String 车辆类型名称
vehicleBelongType String 车辆所属类型
gateLevelAuthArea String 授权范围
auditFlag Integer 审核状态 1审核中 2通过 3驳回 4无需审批
mkmjPermission Integer 进出港权限 1有 2无
visitStartTime String 访问起始时间
visitEndTime String 访问结束时间
expiredExpiration String 有效期是否过期 1过期 2没过期
blockedFlag Integer 1被拉黑 2未拉黑
vehicleCorpId Long 车辆所属企业ID
vehicleCorpName String 车辆所属企业名称
vehicleDepartmentId Long 车辆所属部门id
vehicleDepartmentName String 车辆所属部门名称
employeeVehicleUserId Long 车辆所属人id
employeeVehicleUserName String 车辆所属人名称
drivingUserName String 临时驾驶人姓名
emissionStandards String 排放标准
emissionStandardsName String 排放标准名称
drivingLicenseId String 行驶证照片
attachmentId String 车辆照片
informSignId String 告知签字
projectId Long 项目id
projectName String 项目名称
mkmjId Long 口门id
mkmjName String 口门名称
remarks String 来访事由
lsUserPhone String 临时驾驶人手机号
lsUserIdcard String 临时驾驶人身份证
currentBatchState Integer 当前批次状态
currentAuditUserId Long 当前审批人id
currentAuditUserName String 当前审批人名称
currentAuditDeptId Long 当前审批部门id
currentAuditDeptName String 当前审批部门名称
currentAuditCorpId Long 当前审批企业id
currentAuditCorpName String 当前审批企业名称
currentAuditStatus Integer 当前审批状态
currentAuditTime String 当前审批时间
currentRemarks String 当前备注
checkDepartmentName String 检查部门名称
vehicleAuditLogList List<VehicleAuditLog> 审批记录列表

11.2 新增(检查部门车辆录入)

  • POST /inspectCarSave
  • 请求体：
字段 类型 必填 说明
checkDepartmentName String 是 检查部门名称
vehicleBelongType String 是 车辆所属类型
remarks String 否 名称
inspectCarList List<InspectCar> 否 车辆信息列表
- licenceType String 否 车牌类型
- licenceTypeName String 否 车牌类型名称
- vehicleType String 否 车辆类型
- vehicleTypeName String 否 车辆类型名称
- licenceNo String 否 车牌号
- visitStartTime String 否 访问开始时间
- visitEndTime String 否 访问结束时间
  • 响应：Response

11.3 检查部门车辆修改

  • PUT /inspectCarEdit
  • 请求体：含 id + 车牌/类型等修改字段
  • 响应：Response

11.4 分页查询

  • POST /list
  • 请求体：
字段 类型 必填 说明
licenceNo String 否 车牌号
auditFlag Integer 否 审核状态
visitStartTime String 否 访问起始时间
visitEndTime String 否 访问结束时间
gateLevelAuthAreaId String 否 授权范围
vehicleCorpId Long 否 车辆归属企业ID
vehicleDepartmentId Long 否 车辆归属部门ID
employeeVehicleUserId Long 否 车辆归属员工ID
vehicleBelongType Integer 否 车辆所属类型
remarks String 否 名称
corpName String 否 企业名称
  • 响应：PageResponse<VehicleApplyCO>

11.5 详情 / 删除 / 修改

  • GET /{id} → SingleResponse<VehicleApplyCO>
  • DELETE /{id} → Response
  • PUT /edit → SingleResponse（请求体含 id + 修改字段）

11.6 车牌号唯一性校验

  • GET /check-licence-no?licenceNo=xxx&id=xxx
  • 响应：SingleResponse<Map<String, Object>>

11.7 车牌号黑名单校验

  • GET /check-licence-no-black?licenceNo=xxx
  • 响应：SingleResponse<Map<String, Object>>

11.8 分公司统计

  • POST /fgsCount
  • 请求参数：动态 HashMap
  • 响应：PageResponse<FgsVehicleCountCo>

FgsVehicleCountCo：

字段 类型 说明
corpId Long 企业id
corpName String 企业名称
userCount Integer 人员数
priCarCount Integer 个人车辆数
pubCarCount Integer 单位车辆数

11.9 根据车辆归属查询车辆分页

  • GET /getCarByVehicleBelongType
  • 请求参数：同 11.4
  • 响应：PageResponse<VehicleApplyCO>

11.10 相关方车辆授权

  • POST /xgfCarAuthorization
  • 请求体：
字段 类型 必填 说明
vehicleApplyId Long 否 车辆申请id
mkmjPermission Integer 是 进出港权限 1有 2无
  • 响应：Response

十二、车辆审批 /${gateway}/vehicleAudit

12.1 待审批分页

  • POST /pendingApprovalList
  • 请求体：
字段 类型 必填 说明
employeeVehicleUserName String 否 车辆归属人
licenceNo String 否 车牌号
visitStartTime String 否 访问起始时间
visitEndTime String 否 访问结束时间
vehicleDepartmentId Long 否 车辆归属部门
gateLevelAuthAreaId String 否 授权范围
vehicleBelongTypeArr String 否 车辆所属类型(多选)
vehicleBelongType String 否 车辆所属类型
processOrRecord Integer 否 1审批中 2审批记录
auditStatus Integer 否 审核状态
vehicleApplyId Long 否 车辆申请ID
applyCorpId Long 否 申请企业id
projectName String 否 项目名称
h5UserIdCard String 否 H5身份证号
  • 响应：PageResponse<VehicleAuditCO>

VehicleAuditCO：

字段 类型 说明
id Long 主键
vehicleApplyId String 车辆申请id
batchType Integer 审批批次 1普通 2危险化学品
batchState Integer 审批状态 1申请 2更新
auditTime String 审批时间
auditUserId Long 审批人id
auditUserName String 审批人名称
auditDeptId Long 审批人部门id
auditDeptName String 审批人部门名称
auditCorpId Long 审批人企业id
auditCorpName String 审批人企业名称
auditStatus Integer 1未开始 2通过 3不通过
remarks String 备注
currentUserCanAudit Integer 当前用户是否可审批
changeAfter String 变更后
changeBefore String 变更前
applyUserName String 申请人
+ 车辆申请字段 licenceNo, vehicleType, vehicleBelongType 等

12.2 车辆审批记录

  • POST /carApprovalLogByvehicleApplyIdList
  • 请求体：同 12.1
  • 响应：PageResponse<VehicleAuditCO>

12.3 审批

  • POST /audit
  • 请求体：
字段 类型 必填 说明
id Long 是 审批记录id
vehicleApplyId Long 是 车辆申请id
auditStatus Integer 是 2通过 3不通过
remarks String 否 驳回原因
  • 响应：Response

12.4 详情

  • GET /{id}
  • 响应：SingleResponse<VehicleAuditCO>

十三、车辆违规 /${gateway}/vehicleViolations

13.1 新增

  • POST /save
  • 请求体：
字段 类型 必填 说明
licenceNo String 是 车牌号
licenceType String 否 车牌类型
licenceTypeName String 否 车牌类型名称
vehicleType String 否 车辆类型
vehicleTypeName String 否 车辆类型名称
violationType String 是 违规类型
violationTypeName String 是 违规类型名称
location String 是 违规区域
illegalImagesId String 是 违规图片路径
describeMessage String 是 违规说明
violationtime String 是 违规时间
  • 响应：SingleResponse<VehicleViolationsCO>

VehicleViolationsCO：

字段 类型 说明
id Long 主键
vehicleId Long 车辆id
employeeVehicleUserName String 车辆归属人
licenceNo String 车牌号
violationType String 违规类型
violationTypeName String 违规类型名称
location String 违规区域
illegalImagesId String 违规图片
describeMessage String 违规说明
violationtime String 违规时间
violationProcessingStatus Integer 1已处理 2未处理
violationCount Integer 违规次数

13.2 违规记录分页 / 违规详情记录分页

  • POST /list 或 /detailsRecordList
  • 请求体：
字段 类型 必填 说明
licenceNo String 否 车牌号
violationType String 否 违规类型
  • 响应：PageResponse<VehicleViolationsCO>

13.3 详情 / 删除 / 修改

  • GET /{id} → SingleResponse<VehicleViolationsCO>
  • DELETE /{id} → Response
  • PUT /edit → SingleResponse

十四、车辆黑名单 /${gateway}/vehicleBlack

14.1 新增

  • POST /save
  • 请求体：
字段 类型 必填 说明
licenceNo String 是 车牌号
licenceType String 否 车牌类型
licenceTypeName String 否 车牌类型名称
vehicleType String 否 车辆类型
vehicleTypeName String 否 车辆类型名称
remarks String 否 备注
blockReason String 否 拉黑原因
  • 响应：SingleResponse<VehicleBlackCO>

VehicleBlackCO：

字段 类型 说明
id Long 主键
employeeVehicleUserName String 车辆归属人
licenceNo String 车牌号
licenceType String 车牌类型
licenceTypeName String 车牌类型名称
vehicleType String 车辆类型
vehicleTypeName String 车辆类型名称
remarks String 备注
blockReason String 拉黑原因

14.2 分页查询

  • POST /list
  • 请求体：
字段 类型 必填 说明
licenceNo String 否 车牌号
employeeVehicleUserName String 否 车辆归属人
vehicleDepartmentId Long 否 车辆归属部门
vehicleType String 否 车辆类型
  • 响应：PageResponse<VehicleBlackCO>

14.3 详情 / 删除

  • GET /{id} → SingleResponse<VehicleBlackCO>
  • DELETE /{id} → Response

十五、车辆门禁信息 /${gateway}/vehicleMessage

15.1 新增

  • POST /save
  • 请求体：
字段 类型 必填 说明
licenceType String 是 车牌类型
licenceTypeName String 是 车牌类型名称
licenceNo String 是 车牌号
vehicleType String 是 车辆类型
vehicleTypeName String 是 车辆类型名称
vehicleBelongType String 是 车辆所属类型
gateLevelAuthArea Object 是 授权范围
visitStartTime String 是 授权访问起始时间
visitEndTime String 是 授权访问结束时间
vehicleApplyId Long 是 车辆申请id
remarks String 是 备注
syncStatus Integer 是 对接状态 1完成 2未对接
syncRemarks String 是 对接说明
  • 响应：SingleResponse<VehicleMessageCO>

15.2 分页 / 全部 / 详情 / 删除 / 批量删除 / 修改

  • POST /list → PageResponse<VehicleMessageCO>
  • GET /listAll → MultiResponse<VehicleMessageCO>
  • GET /{id} → SingleResponse<VehicleMessageCO>
  • DELETE /{id} → Response
  • DELETE /ids?ids=1&ids=2 → Response
  • PUT /edit → SingleResponse

十六、车辆对接日志 /${gateway}/vehicleDockLog

16.1 新增

  • POST /save
  • 请求体：
字段 类型 必填 说明
level String 是 1一级口门 2二级口门
vehicleBelongType String 是 车辆所属类型
licenceNo String 是 车牌号
applyName String 是 申请人名称
applyTime String 是 申请时间
auditName String 是 审批人名称
auditTime String 是 审批时间
portArea String 是 港区 0全部 1东港 2西港
validDte String 是 有效期
truckCardColor String 是 车牌颜色
truckTypCod String 是 车辆类型
yqlCheckFlag String 是 运全路 0不可以 1可以
driverNam String 是 司机名称
truckAppTypCod String 是 申请类别 1公务 2生产 3政府 4职工 5客户
dockFlag String 是 对接状态 1没对接 2已对接
dockStatus String 是 1对接失败 2对接成功
reasonsRefusal String 是 对接失败原因
  • 响应：SingleResponse<VehicleDockLogCO>

16.2 分页 / 全部 / 详情 / 删除 / 批量删除 / 修改

  • POST /list → PageResponse<VehicleDockLogCO>
  • GET /listAll → MultiResponse<VehicleDockLogCO>
  • GET /{id} → SingleResponse<VehicleDockLogCO>
  • DELETE /{id} → Response
  • DELETE /ids?ids=1,2 → Response
  • PUT /edit → SingleResponse

十七、人员申请审批 /${gateway}/personApply

17.1 相关方人员申请新增

  • POST /xgfPersonSave
  • 请求体：
字段 类型 必填 说明
personBelongType Integer 是 3相关方 4临时人员
gateLevelAuthArea String 是 授权范围港区与区域
visitStartTime String 是 访问起始时间
visitEndTime String 是 访问结束时间
informSignId String 否 告知签字
mkmjId Long 否 口门id
mkmjName String 否 口门名称
projectId Long 否 项目id
projectName String 否 项目名称
reasonVisit String 否 来访事由
auditCorpId Long 否 审核企业
auditCorpName String 否 审核企业名称
auditDeptId Long 否 审核部门
auditDeptName String 否 审核部门名称
auditUserId Long 否 审核用户
auditUserName String 否 审核用户名称
personApplyList List<PersonApplyAddCmdExt> 否 待审批人员列表
- personCorpId Long 否 企业ID
- personCorpName String 否 企业名称
- personDepartmentId Long 否 部门id
- personDepartmentName String 否 部门名称
- employeePersonUserId Long 否 人员id
- employeePersonUserName String 是 人员姓名
- userFaceUrl String 是 头像
- userPhone String 是 手机号
- userCard String 是 身份证号
- visitStartTime String 否 访问起始时间
- visitEndTime String 否 访问结束时间
  • 响应：Response

17.2 相关方/临时人员审批

  • POST /xgfPersonAudit
  • 请求体：
字段 类型 必填 说明
id Long 是 主键
auditFlag Integer 是 2通过 3驳回
reasonsRefusal String 否 驳回理由
  • 响应：Response

17.3 相关方人员权限记录列表

  • POST /xgfPersonPermissionsList
  • 请求体：
字段 类型 必填 说明
processOrRecord Integer 否 1审批中 2审批记录
projectName String 否 项目名称
applyCorpName String 否 申请单位名称
auditFlag Integer 否 审核状态
userCard String 否 身份证号
employeePersonUserName String 否 姓名
applyCorpId Long 否 申请企业ID
  • 响应：PageResponse<PersonApplyCO>

PersonApplyCO：

字段 类型 说明
id Long 主键
xgfApplyPersonId Long 相关方申请人员id
personBelongType Integer 人员所属类型
visitStartTime String 访问起始时间
visitEndTime String 访问结束时间
personCorpId Long 企业ID
personCorpName String 企业名称
personDepartmentId Long 部门id
personDepartmentName String 部门名称
employeePersonUserId Long 人员id
employeePersonUserName String 人员姓名
userFaceUrl String 头像
userPhone String 手机号
userCard String 身份证号
informSignId String 告知签字
projectId Long 项目id
projectName String 项目名称
mkmjId Long 口门id
mkmjName String 口门名称
currentUserCanAudit Integer 当前用户是否可审批
mkmjPermission Integer 进出港权限
gateLevelAuthArea String 授权范围
auditUserId String 审批人id
auditUserName String 审批人名称
auditDeptId String 审批人部门id
auditDeptName String 审批人部门名称
auditCorpId String 审批人企业id
auditCorpName String 审批人企业名称
auditTime String 审批时间
userUid String 用户uid
createTime String 创建时间

17.4 相关方人员权限详情

  • GET /xgfPersonPermissionsInfo/{id}
  • 响应：SingleResponse<PersonApplyCO>

17.5 相关方人员申请详情

  • GET /xgfPersonApplyInfoById/{id}
  • 响应：SingleResponse<XgfPersonApplyCO>

17.6 待审批相关方申请人员列表

  • POST /xgfPersonAuditList
  • 响应：PageResponse<XgfPersonApplyCO>

17.7 相关方人员入场申请列表

  • POST /xgfPersonApplyList
  • 响应：PageResponse<XgfPersonApplyCO>

17.8 临时访客人员入场申请列表(H5)

  • POST /tmpPersonApplyH5List
  • 响应：PageResponse<PersonApplyCO>

17.9 人员临时申请审批待审批分页

  • POST /pendingApprovalList
  • 请求体：
字段 类型 必填 说明
xgfApplyPersonId Long 否 相关方人员申请ID
employeePersonUserName String 否 访问人姓名
personBelongType String 否 3相关方 4临时人员
auditFlag Integer 否 审核状态
processOrRecord Integer 否 1待审批 2已审批
visitStartTime String 否 访问开始时间
visitEndTime String 否 访问结束时间
  • 响应：PageResponse<XgfPersonApplyCO>

17.10 相关方人员及车辆管理首页分页

  • GET /xgfPersonnelVehicleManagementList
  • 请求参数：
字段 类型 必填 说明
name String 否 姓名
projectName String 否 项目名称
sex Long 否 性别
departmentId Long 否 部门ID
corpId Long 否 公司ID
  • 响应：PageResponse<XgfPersonCountCO>

XgfPersonCountCO：

字段 类型 说明
userId Long 用户id
userName String 姓名
userCard String 身份证号
userPhone String 手机号
corpinfoId Long 企业id
corpName String 企业名称
applyCorpId Long 申请企业id
applyCorpName String 申请企业名称
departmentId Long 部门id
departmentName String 部门名称
postName String 岗位名称
projectId Long 项目id
projectName String 项目名称
visitStartTime String 访问起始时间
visitEndTime String 访问结束时间
xgfApplyPersonId Long 相关方申请人员id
applyPersonId Long 申请人员id
vehicleCount Integer 车辆数
projectCount Integer 项目数
mkmjPermission Integer 进出港权限

17.11 股份/分公司人员及车辆管理分页

  • GET /personnelVehicleManagementList
  • 请求参数：同 17.10
  • 响应：PageResponse<PersonCountCO>

PersonCountCO：

字段 类型 说明
userId Long 用户id
userName String 姓名
userCard String 身份证号
userPhone String 手机号
userFaceUrl String 头像
corpinfoId Long 企业id
corpName String 企业名称
departmentId Long 部门id
departmentName String 部门名称
postName String 岗位名称
projectId Long 项目id
projectName String 项目名称
visitStartTime String 访问起始时间
visitEndTime String 访问结束时间
xgfApplyPersonId Long 相关方申请人员id
applyPersonId Long 申请人员id
vehicleCount Integer 车辆数
mkmjPermission Integer 进出港权限

17.12 相关方人员授权

  • POST /xgfPersonAuthorization
  • 请求体：
字段 类型 必填 说明
applyPersonId Long 否 项目申请人员ID
xgfApplyPersonId Long 否 相关方申请人员ID
personBelongType Integer 是 1股份 2分公司 3相关方
corpinfoId Long 否 企业ID
corpName String 否 企业名称
departmentId Long 否 部门id
departmentName String 否 部门名称
userId Long 否 人员id
userName String 否 人员姓名
userFaceUrl String 否 头像
userPhone String 否 手机号
userCard String 否 身份证号
gateLevelAuthArea String 是 授权范围
mkmjPermission Integer 是 进出港权限 1有 2无
  • 响应：Response

17.13 股份/分公司人员授权

  • POST /authorization
  • 请求体：同 17.12
  • 响应：Response

17.14 详情 / 删除

  • GET /{id} → SingleResponse<PersonApplyCO>
  • DELETE /{id} → Response

十八、人员门禁信息 /${gateway}/personMessage

18.1 新增

  • POST /save
  • 请求体：
字段 类型 必填 说明
personApplyId Long 是 人员申请id
personBelongType Integer 是 1股份 2分公司 3相关方 4临时人员
userFaceUrl String 是 头像
userCard String 是 身份证号
gateLevelAuthArea String 是 授权范围
visitStartTime String 是 授权访问起始时间
visitEndTime String 是 授权访问结束时间
remarks String 是 备注
syncStatus Integer 是 对接状态 1完成 2未对接
syncRemarks String 是 对接说明
  • 响应：SingleResponse<PersonMessageCO>

PersonMessageCO：

字段 类型 说明
id Object 主键
personApplyId Long 人员申请id
personBelongType Integer 人员所属类型
userFaceUrl String 头像
userCard String 身份证号
gateLevelAuthArea Object 授权范围
visitStartTime String 授权访问起始时间
visitEndTime String 授权访问结束时间
remarks String 备注
syncStatus Integer 对接状态
syncRemarks String 对接说明

18.2 分页 / 全部 / 详情 / 删除 / 批量删除 / 修改

  • POST /list → PageResponse<PersonMessageCO>
  • GET /listAll → MultiResponse<PersonMessageCO>
  • GET /{id} → SingleResponse<PersonMessageCO>
  • DELETE /{id} → Response
  • DELETE /ids?ids=1&ids=2 → Response
  • PUT /edit → SingleResponse

十九、电动车基础信息 /${gateway}/eVehicleBasicInfo

19.1 新增

  • POST /save
  • 请求体（均非必填）：
字段 类型 说明
vehicleRecordId String 车辆ID
vehicleFilingInfoRecordingOrg String 备案信息录入单位
vehicleOwningEntity String 车辆归属单位
vehiclePlateNumber String 车辆牌照号码
vehicleRegistrationNumber String 车辆行驶证号码
vehicleCategoryName String 车辆类型名称
vehiclePlateColorName String 车辆牌照颜色名称
vehicleFilingTime String 备案时间
vehicleContactName String 联系人姓名
vehicleContactPhoneNumber String 联系人电话
vehicleFilingMethod String 备案分类 1长期 2一次性 3内部 4临时
edwValidFlag String 有效标识
edwDataSource String 数据源头
edwCreateDate String 创建时间
edwLastUpdate String 更新时间
dataVersion Long 分区列
accLastUpdateDate String 同步时间
idSequence Long 序列号
  • 响应：SingleResponse<EVehicleBasicInfoCO>

19.2 分页 / 全部 / 详情 / 删除 / 批量删除 / 修改

  • POST /list → PageResponse<EVehicleBasicInfoCO>
  • GET /listAll → MultiResponse<EVehicleBasicInfoCO>
  • GET /{id} → SingleResponse<EVehicleBasicInfoCO>
  • DELETE /{id} → Response
  • DELETE /ids?ids=1,2 → Response
  • PUT /edit → SingleResponse

二十、电动车到离港信息 /${gateway}/eVehicleArrivalDepartureInfo

20.1 新增

  • POST /save
  • 请求体：
字段 类型 必填 说明
dataVersion String 是 data_version
idSequence Integer 是 id_sequence
accLastUpdateDate String 是 同步时间
edwCreateDate String 是 创建时间
edwDataSource String 是 数据源头
edwLastUpdate String 是 更新时间
edwValidFlag String 是 有效标识
vehicleArrivalBarrier String 是 进港闸口
vehicleArrivalStatus String 是 进港状态
vehicleArrivalTime String 是 进港时间
vehicleCategoryName String 是 车辆类型名称
vehicleContactName String 是 联系人姓名
vehicleContactPhoneNumber String 是 联系人电话
vehicleDepartureBarrier String 是 出港闸口
vehicleDepartureTime String 是 出港时间
vehicleFilingInfoRecordingOrg String 是 备案信息录入单位
vehicleFilingMethod String 是 备案分类
vehiclePlateColor String 是 车牌颜色
vehiclePlateNumber String 是 车牌号
vehicleRecordId String 是 车辆ID
vehicleRegistrationNumber String 是 行驶证号码
vehicleSequenceNumber String 是 序列号
jjbsaasdatacenterid Long 是 数据中心ID
  • 响应：SingleResponse<EVehicleArrivalDepartureInfoCO>

20.2 分页查询

  • POST /list
  • 请求体：
字段 类型 必填 说明
vehiclePlateNumber String 否 车牌号
startVehicleArrivalTime String 否 进港开始时间
endVehicleArrivalTime String 否 进港结束时间
startVehicleDepartureTime String 否 出港开始时间
endVehicleDepartureTime String 否 出港结束时间
  • 响应：PageResponse<EVehicleArrivalDepartureInfoCO>

20.3 全部 / 详情 / 删除 / 批量删除 / 修改

  • GET /listAll → MultiResponse<EVehicleArrivalDepartureInfoCO>
  • GET /{id} → SingleResponse<EVehicleArrivalDepartureInfoCO>
  • DELETE /{id} → Response
  • DELETE /ids?ids=1,2 → Response
  • PUT /edit → SingleResponse

二十一、App统计角标 /${gateway}/appStatisticsCorner

21.1 获取App统计角标

  • GET /getAppCount
  • 请求参数：无
  • 响应：MultiResponse<AppCountCO>

AppCountCO：

字段 类型 说明
type String 类型: one_level_car / two_level_car / one_level_person / two_level_person
belongType String 所属类型
auditUserId Long 审批人ID
waitAuditCount int 待审批数量

二十二、车辆进出记录 /${gateway}/dahuaVehicleAccessRecord

22.1 分页查询

  • POST /list
  • 请求体：
字段 类型 必填 说明
pageIndex Integer 是 页码
pageSize Integer 是 每页数量
carNum String 否 车牌号，支持模糊查询，同时匹配进港和离港车牌
enterTimeStart String 否 进港开始时间，格式：yyyy-MM-dd HH:mm:ss
enterTimeEnd String 否 进港结束时间，格式：yyyy-MM-dd HH:mm:ss
exitTimeStart String 否 离港开始时间，格式：yyyy-MM-dd HH:mm:ss
exitTimeEnd String 否 离港结束时间，格式：yyyy-MM-dd HH:mm:ss
  • 响应：PageResponse<DaHuaVehicleAccessRecordCO>

DaHuaVehicleAccessRecordCO：返回 dahua_vehicle_access_record 表全部字段，并补充以下查询字段：

字段 类型 说明
vehicleOwnerName String 车辆所属人，按车牌匹配最新有效车辆申请，优先取所属人，其次取驾驶人
vehiclePortStatus String 车辆在港状态：在港、已离港、未知
enterMkmjName String 进港口门名称，优先使用大华通道绑定；未绑定时按道闸编码唯一匹配本平台口门
exitMkmjName String 离港口门名称，优先使用大华通道绑定；未绑定时按道闸编码唯一匹配本平台口门