# 停车场的记录分页查询

最新更新时间:2023.06.13

查询某个停车场某日下全部的停车驶入驶出的记录,支持分页查询


# 接口说明

请求URL: https://{domain}/os-park/ospark/open/api/v2/parkingRecordList

请求方式: POST

公共请求参数

参数名 必填 类型 说明
access_id 是 string 开发者唯一标识
sign_type 是 string 固定传RSA2
time_stamp 是 long 请求时间,Linux时间戳,单位毫秒
sign 是 string 签名结果
data 是 string 将业务参数转为JSON字符串,然后使用BASE64编码的数据

详细签名方法请阅读接口加密方案

请求参数

名称 必填 类型 说明
osStoreCode 是 string 备案系统中停车场编码(开放平台门店Code)
osMerchantId 否 Long 订单归属商户号
osPartnerId 否 Long 订单归属服务商号
orderId 否 String 订单记录号
carPlate 否 String 车牌号
carPlateColor 否 Integer 车牌颜色
parkingType 否 Integer 停车类型 1:临时车;2:包月车;3:特殊车
inStartDate 否 Date 驶入开始时间
inEndDate 否 Date 驶入结束时间
outStartDate 否 Date 驶出开始时间
outEndDate 否 Date 驶出结束时间
status 否 Integer 在停状态 0在停 1已完成
page 否 Integer 当前页 默认:0
size 否 Integer 每页查询数 默认:20

返回参数

名称 必填 类型 说明
content 是 Object 列表内容
content.billingAmount 否 String 计费金额 (元)
content.carPlate 否 String 车牌号,无牌车统一设置为 "无牌车"
content.carPlateColor 否 Integer 车牌颜色 1-蓝色 2-黄色 3-白色 4-黑色 5-绿色 6-黄绿双拼色 常量定义在SDK的TyhConstants.CarPlateColor中
content.carPlateColorDesc 否 String 车牌颜色描述
content.inTime 否 Date 入场时间
content.outTime 否 Date 出场时间
content.merchantName 否 String 公司名称
content.orderId 否 String 订单记录号
content.parkingLotName 否 String 停车场名称
content.partnerName 否 String 服务商名称
content.payAmount 否 String 支付金额 (元)
content.status 否 Number 在停状态
content.statusDesc 否 String 在停状态描述
first 否 Boolbean 是否第一页
last 否 Boolbean 是否最后一页
number 是 Integer 当前页
numberOfElements 是 Integer 每页数量
size 是 Integer 每页数量
totalElements 是 Number 总条数
totalPages 是 Integer 总页数

SDK方法

// 创建上传数据client
TyhUploadClient client = TyhUploadClient.create(TyhOptions.builder()
    .accessId(ACCESS_ID)
    .secretKey(SECRET_KEY)
    .build());
    
// 停车数据停车记录列表
OpenParkingDriveRecordCmd cmd = OpenParkingDriveRecordCmd.builder().page(1).size(5).status(0).build();

// 发送请求 result.ifSuccess()表示请求成功
Results<Page<OpenParkingDriveRecordDto>> results = client.driveRecordList(cmd);

入参格式

{
	"osStoreCode": "3163757684139653"
  "queryDate": "2022-03-17"
}

出参格式:

{ "code":8888, "msg":"success", "data": "{"content":[{"billingAmount":"0","carPlate":"京CTN1500","carPlateColor":1,"carPlateColorDesc":"蓝色","inTime":1647242497000,"merchantName":"合肥城市泊车投资管理有限公司蜀山分公司","orderId":"55314890381852672","parkingLotName":"测试停车场","partnerName":"合肥城泊","payAmount":"0","status":0,"statusDesc":"在停"},{"billingAmount":"0","carPlate":"无牌车","carPlateColor":1,"carPlateColorDesc":"蓝色","inTime":1647242487000,"merchantName":"合肥城市泊车投资管理有限公司蜀山分公司","orderId":"55314848006799360","parkingLotName":"测试停车场","partnerName":"合肥城泊","payAmount":"0","status":0,"statusDesc":"在停"},{"billingAmount":"0","carPlate":"皖EF8512","carPlateColor":1,"carPlateColorDesc":"蓝色","inTime":1647242145000,"merchantName":"合肥城市泊车投资管理有限公司蜀山分公司","orderId":"55313412254597120","parkingLotName":"测试停车场","partnerName":"合肥城泊","payAmount":"0","status":0,"statusDesc":"在停"},{"billingAmount":"0","carPlate":"皖EF8512","carPlateColor":1,"carPlateColorDesc":"蓝色","inTime":1647241986000,"merchantName":"合肥城市泊车投资管理有限公司蜀山分公司","orderId":"55312746979262464","parkingLotName":"测试停车场","partnerName":"合肥城泊","payAmount":"0","status":0,"statusDesc":"在停"},{"billingAmount":"0","carPlate":"无牌车","carPlateColor":1,"carPlateColorDesc":"蓝色","inTime":1647241660000,"merchantName":"合肥城市泊车投资管理有限公司蜀山分公司","orderId":"55311379631964160","parkingLotName":"测试停车场","partnerName":"合肥城泊","payAmount":"0","status":0,"statusDesc":"在停"}],"first":false,"last":false,"number":1,"numberOfElements":5,"size":5,"totalElements":42,"totalPages":9}"}

code 为 8888 表示操作成功,其它值则为失败,具体内容参见错误码说明。