管理卡券接口

查看卡券详情接口

HTTP 请求方式

  1. GET https://openapi.baidu.com/rest/2.0/smartapp/v1.0/coupon/get?access_token=ACCESS_TOKEN

请求参数

参数说明类型是否必传
couponId卡券 IDString是

返回示例

  1. {
  2.     "errno":0,
  3.     "msg":"success",
  4.     "data":{
  5.         "couponId":"xxxx",
  6.         "couponType":"DISCOUNT",
  7.         "discount":30,
  8.         "baseInfo":{
  9.             "title":"卡券标题",
  10.             "color":"B10",
  11.             "getLimit":3,
  12.             "dateInfo":{
  13.                 "getStartTimestamp":1574952776,
  14.                 "getEndTimestamp":1577544776,
  15.                 "type":1,
  16.                 "beginTimestamp":1574952776,
  17.                 "endTimestamp":1577544776,
  18.                 "timeUnit":1,
  19.                 "timeValue":22
  20.             }
  21.         },
  22.         "description":"使用描述",
  23.         "callbackUrl":"卡券事件回调地址"
  24.     }
  25. }

批量查询卡券列表接口

接口描述：批量查询卡券接口。

HTTP 请求方式

  1. GET https://openapi.baidu.com/rest/2.0/smartapp/v1.0/coupon/batchGet?access_token=ACCESS_TOKEN

请求参数

参数说明类型是否必传默认值
title券名称String否
couponType券类型String否
pageNum页码，默认值为：0Int否0
pageSize页大小，默认值为：20Int否20

返回示例

  1. {
  2.     "errno": 0,
  3.     "msg": "success",
  4.     "data": {
  5.         // 页码
  6.         "pageNo": 1,
  7.         // 总数量
  8.         "total": 3,
  9.         "dataList": [
  10.             {
  11.                 "couponType": "DISCOUNT",
  12.                 "discount": 30,
  13.                 "baseInfo": {
  14.                     "title": "卡券标题",
  15.                     "color": "B10",
  16.                     "getLimit": 3,
  17.                     "dateInfo": {
  18.                         "getStartTimestamp": 1574952776,
  19.                         "getEndTimestamp": 1577544776,
  20.                         "type": 1,
  21.                         "beginTimestamp": 1574952776,
  22.                         "endTimestamp": 1577544776,
  23.                         "timeUnit": 1,
  24.                         "timeValue": 22
  25.                     }
  26.                 },
  27.                 "description": "使用描述",
  28.                 "callbackUrl": "卡券事件回调地址"
  29.             }
  30.         ]
  31.     }
  32. }

删除卡券接口

HTTP 请求方式

  1. POST/form https://openapi.baidu.com/rest/2.0/smartapp/v1.0/coupon/delete?access_token=ACCESS_TOKEN

请求参数

参数说明类型是否必传
couponId卡券 IDString是

返回示例

  1. {
  2.     "errno": 0,
  3.     "msg": "success",
  4.     "data": true
  5. }

返回参数说明

参数名描述
errno错误码
msg错误信息
datatrue 退还成功 false 退还失败