推送异常放行记录
请求地址
POST https://api.4pyun.com/gate/1.0/parking/internal/release
特殊说明
注意事项
- 同一停车场
parking_serial不能重复, 重复的流水将被忽略! - 传文件有外网可访问图片直接传
capture_image，否则这个字段传递文件字节流即可。 - 发对接过程中签名错误等信息不会直接返回错误状态码，对接过程中就判断返回结果里面是否有hint值，如果有根据hint的返回查错误原因，正式上线之后只判断code是否为200，200代表成功
请求参数
| 字段名称 | 字段说明 | 类型 | 必填 | 示例 |
|---|---|---|---|---|
| app_id | 平台分配的接入应用ID, 车场本地发起请求可不传递 | string | N | op1234567723122 |
| sign | 请求数据签名 | string | Y | C65FCAC2D3FB5E2D3D4AD93DD20C8C39 |
| release_type | 放行类型: 1-入场, 2-出场 | int | Y | 1 |
| park_uuid | 平台分配的停车场UUID | string | Y | PARKUUID-XXXX-XXX-XXX |
| parking_serial | 停车场端的停车流水, 一般为入场记录ID | string | Y | PARKINGSERIAL-123456789 |
| plate | 车牌号码 | string | Y | 粤B12345 |
| plate_color | 车牌颜色: 1.蓝色, 2.黄色, 3.白色, 4.黑色, 5.绿色, -1 未知 | string | N | 1 |
| release_time | 放行时间, 格式: yyyy-MM-dd'T'HH:mm:ss'Z' 特别说明UTC时间和普通时间差8小时因为我们在东八区 2022-09-01T00:00:00.000Z 对应时间的时间是 2022-09-01 08:00:00 |
string | N | 2021-09-02T09:36:46.020Z |
| capture_image | 抓拍图片路径 | string | N | 可访问云平台路径-->https://files.4pyun.com/d/123566 |
| gate_name | 通道名称 | string | N | 通道A |
| gate_id | 通道编号 | string | N | 1001 |
| car_type | 车类: 1.临停车辆, 2.月卡车辆, 3.贵宾车辆(免费车), 4.储值车辆, 0.其他未知 | string | N | 1 |
| car_desc | 车类描述 | string | N | 临停/月卡A |
| operator | 操作员 | string | N | 张三 |
| reason | 放行原因 | string | N | 设备异常 |
| release_method | 放行方式: 0 - 未知,1 - 手动放行 ,2 - 自动放行,3 - 可疑跟车 | string | N | 1 |
| release_method_desc | 放行方式描述 | string | N | 遥控开闸 |
返回结果参数说明
| 字段名称 | 字段说明 | 类型 | 必填 | 备注 |
|---|---|---|---|---|
| code | 请求状态码 | string | Y | 1001-成功受理 400:参数错误 403:访问被拦截 500:服务器内部错误 503:服务暂不可用 |
| message | 返回描述 | string | Y | 返回描述 |
| hint | 返回错误说明 | string | N | 返回具体错描述指导 |
| seqno | 服务器日志标示 | string | Y | 查日志用到查问题尽量提供这个值 |
返回结果示例
正常返回
{
"code": "1001",
"message": "OK",
"seqno": "abc6c253b93cc940",
"data_node": "CN-South/HS3-1"
}
{
"code":"401",
"message":"请求签名校验不通过",
"hint":"park_uuid=49f0cc52-e8c7-41e3-b54d-af666b8cc11a&parking_serial=parking_serialxxxxx&plate=?KKKKKK&release_time=2023-03-21T15:59:59Z&app_secret=***",
"seqno":"17224239894628849085663174788803",
"data_node":"CN-South/DEV-1",
"path":"POST /gate/1.0/parking/internal/release"
}