事件优惠下发
一个第三方服务对应一个车场的下发优惠券类型固定,由平台配置
1 请求地址
- 测试环境:https://dev-api.4pyun.com/gate/1.0/parking/mcoupon/event
- 生产环境:https://api.4pyun.com/gate/1.0/parking/mcoupon/event
2 请求方式
POST application/json
3 请求头
| 字段名称 | 类型 | 必填 | 字段说明 |
|---|---|---|---|
| Authorization | string | true | 签名值 |
4 请求参数
| 字段名称 | 类型 | 必填 | 字段说明 |
|---|---|---|---|
| app_id | string | true | 平台分配的接入应用ID |
| api_store_code | string | true | 车场对应第三方平台ID |
| api_type | string | true | 第三方服务类型(该字段由平台分配,固定) |
| event_id | string | true | 第三方订单号, 需保证在第三方平台唯一 |
| plate | string | true | 车牌号 |
| subject | string | true | 优惠事件描述,如“【粤BD07627】于【2020-09-08 17:15:58 - 2020-09-08 17:45:26】充电 1119.62 KWH 时长 29 分钟” |
| metadata | map |
false | 业务元数据, 该参数key为表示业务类型的某一固定值,由平台提供;EventMetadata参数参考下方;该字段固定优惠规则可不传; |
EventMetadata
| Name | Type | Required | Description |
|---|---|---|---|
| name | string | true | 数据名称,该参数仅用于数据值说明 |
| value | int32 | true | 数据值,调用方的业务变量,该参数结合metadata的key会决定下发优惠方案 |
5 响应参数
| 字段名称 | 类型 | 必填 | 字段说明 |
|---|---|---|---|
| code | string | false | 返回Code值: 1001 优惠派发成功 1002 车辆未入场 1003 优惠限制 1401 第三方优惠配置不存在 1403 重复派发 1405 车场下发失败 1500 内部错误, 提示message的信息 |
| message | string | false | none |
| hint | string | false | none |
| seqno | string | false | none |
| data_node | string | false | none |
| time_cost | integer(int64) | false | none |