临停优惠

API 列表

请求方式	API	描述
POST	/v1.0/iot-02/third/parking/coupons	创建车行优惠券
PUT	/v1.0/iot-02/third/parking/coupons/{coupon_id}	修改车行优惠券
DELETE	/v1.0/iot-02/third/parking/coupons/{coupon_id}	删除车行优惠券
GET	/v1.0/iot-02/third/parking/coupons/{coupon_id}	查询车行优惠券详情
GET	/v1.0/iot-02/third/parking/coupons	查询车行优惠券列表
POST	/v1.0/iot-02/third/parking/coupon/apply	使用车行优惠券

创建车行优惠券

功能描述

创建车行优惠券

接口地址

POST /v1.0/iot-02/third/parking/coupons

请求参数

参数名	类型	参数类型	说明	是否必需
coupon_name	String	body	优惠券名称	true
coupon_type	String	body	优惠券类型，(ALL_FREE:全免；REDUCE_AMOUNT:减免金额；REDUCE_HOUR:减免时长)	true
coupon_value	long	body	优惠券面值	true
remark	String	body	备注	false

返回参数

参数名	类型	说明
code	Integer	响应码（详情见错误码章节），成功时为空
success	Boolean	是否成功：（true：成功，false：失败）
msg	String	请求失败的信息，成功时为空
t	Long	返回时间戳，13 位
result	String	优惠券 id

请求示例

POST /v1.0/iot-02/third/parking/coupons
{
  "coupon_name": "tIM5tN4j3r",
  "coupon_type": "ALL_FREE",
  "coupon_value": 584097,
  "remark": "8uupLjsjQN"
}

响应示例

{
  "success": true,
  "t": 1573441137,
  "result": "eOdZT9i71Y"
}

修改车行优惠券

功能描述

修改车行优惠券

接口地址

PUT /v1.0/iot-02/third/parking/coupons/{coupon_id}

请求参数

参数名	类型	参数类型	说明	是否必需
coupon_id	String	url	优惠券 id	true
coupon_name	String	body	优惠券名称	true
coupon_type	String	body	优惠券类型 CouponTypeEnum，(ALL_FREE:全免；REDUCE_AMOUNT:减免金额；REDUCE_HOUR:减免时长)	true
coupon_value	long	body	优惠券面值	true
remark	String	body	备注	false

返回参数

参数名	类型	说明
code	Integer	响应码（详情见错误码章节），成功时为空
success	Boolean	是否成功：（true：成功，false：失败）
msg	String	请求失败的信息，成功时为空
t	Long	返回时间戳，13 位
result	boolean	成功、失败

请求示例

PUT /v1.0/iot-02/third/parking/coupons/{coupon_id}
{
  "coupon_name": "TgMSQFWSzh",
  "coupon_type": "ALL_FREE",
  "coupon_value": 3943,
  "remark": "n3ADxXMA1f"
}

响应示例

{
  "success": true,
  "t": 1573441137,
  "result": true
}

删除车行优惠券

功能描述

删除车行优惠券

接口地址

DELETE /v1.0/iot-02/third/parking/coupons/{coupon_id}

请求参数

参数名	类型	参数类型	说明	是否必需
coupon_id	String	url	优惠券 id	true

返回参数

参数名	类型	说明
code	Integer	响应码（详情见错误码章节），成功时为空
success	Boolean	是否成功：（true：成功，false：失败）
msg	String	请求失败的信息，成功时为空
t	Long	返回时间戳，13 位
result	boolean	成功、失败

请求示例

DELETE /v1.0/iot-02/third/parking/coupons/{coupon_id}

响应示例

{
  "success": true,
  "t": 1573441137,
  "result": false
}

查询车行优惠券详情

功能描述

查询车行优惠券详情

接口地址

GET /v1.0/iot-02/third/parking/coupons/{coupon_id}

请求参数

参数名	类型	参数类型	说明	是否必需
coupon_id	String	url	优惠券 id	true

返回参数

参数名	类型	说明
code	Integer	响应码（详情见错误码章节），成功时为空
success	Boolean	是否成功：（true：成功，false：失败）
msg	String	请求失败的信息，成功时为空
t	Long	返回时间戳，13 位
result	Object	优惠券信息

result参数说明

参数名	类型	说明
project_id	String	项目 id
creator	String	创建者
modifier	String	修改者
gmt_create	long	创建时间（毫秒）
gmt_modified	long	修改时间（毫秒）
coupon_id	String	优惠券 ID
coupon_name	String	优惠券名称
coupon_type	String	优惠券类型，(ALL_FREE:全免；REDUCE_AMOUNT:减免金额；REDUCE_HOUR:减免时长)
coupon_value	long	优惠券面值
remark	String	备注

请求示例

GET /v1.0/iot-02/third/parking/coupons/{coupon_id}

响应示例

{
  "success": true,
  "t": 1573441137,
  "result": {
    "project_id": "i1aE4ubty1",
    "creator": "IOMJzDRBeP",
    "modifier": "KJTEP5Vsiq",
    "gmt_create": 454459,
    "gmt_modified": 247715,
    "coupon_id": "ADH1UvUen4",
    "coupon_name": "9JTTweh9kg",
    "coupon_type": "ALL_FREE",
    "coupon_value": 821197,
    "remark": "YfR2DicTTX"
  }
}

查询车行优惠券列表

功能描述

查询车行优惠券列表

接口地址

GET /v1.0/iot-02/third/parking/coupons

请求参数

参数名	类型	参数类型	说明	是否必需
page_no	int	query	页码，最小值 1	false
page_size	int	query	页大小，最小值 1，最大值 1000	false
coupon_name	String	query	优惠券名称	false

返回参数

参数名	类型	说明
code	Integer	响应码（详情见错误码章节），成功时为空
success	Boolean	是否成功：（true：成功，false：失败）
msg	String	请求失败的信息，成功时为空
t	Long	返回时间戳，13 位
result	Object	优惠券分页列表

result参数说明

参数名	类型	说明
total	int	总数
data	Object[]	当前页数据
project_id	String	项目 id
creator	String	创建者
modifier	String	修改者
gmt_create	long	创建时间（毫秒）
gmt_modified	long	修改时间（毫秒）
coupon_id	String	优惠券 ID
coupon_name	String	优惠券名称
coupon_type	String	优惠券类型，(ALL_FREE:全免；REDUCE_AMOUNT:减免金额；REDUCE_HOUR:减免时长)
coupon_value	long	优惠券面值
remark	String	备注

请求示例

GET /v1.0/iot-02/third/parking/coupons?page_no=1&page_size=100&coupon_name=PkBsus1Tky

响应示例

{
  "success": true,
  "t": 1573441137,
  "result": {
    "total": 1,
    "data": [
      {
        "project_id": "MGxbOFIOhB",
        "creator": "xNHuTyWOqd",
        "modifier": "xzfPPTPYKj",
        "gmt_create": 32777,
        "gmt_modified": 601617,
        "coupon_id": "KgV1K5Ptj0",
        "coupon_name": "iKmHN6C87E",
        "coupon_type": "ALL_FREE",
        "coupon_value": 547741,
        "remark": "o44374sPPV"
      }
    ]
  }
}

使用车行优惠券

功能描述

使用车行优惠券

接口地址

POST /v1.0/iot-02/third/parking/coupon/apply

请求参数

参数名	类型	参数类型	说明	是否必需
coupon_id	String	body	优惠券 ID	true
plate_number	String	body	车牌号码	true
in_parking_id	String	body	车辆通行记录 ID	true

返回参数

参数名	类型	说明
code	Integer	响应码（详情见错误码章节），成功时为空
success	Boolean	是否成功：（true：成功，false：失败）
msg	String	请求失败的信息，成功时为空
t	Long	返回时间戳，13 位
result	boolean	成功、失败

请求示例

POST /v1.0/iot-02/third/parking/coupon/apply
{
  "coupon_id": "sIzaFRgQ3H",
  "plate_number": "浙A12345",
  "in_parking_id": "4Vsw4PR2JN"
}

响应示例

{
  "success": true,
  "t": 1573441137,
  "result": false
}