Skip to content

用户优惠券列表

请求路径

  • 请求方式:POST
  • 请求头:Content-Type:application/json
  • 接口地址:https://gateway.nuoyunapi.com/Api/Coupon/getUserCouponList/2.0.0
  • 频率限制:10秒1000次

请求参数

参数名必选类型说明
wechat_user_space_idinteger用户id
coupon_typeinteger优惠券类型 1 商品券 2 奖品兑换券
pageinteger页码
page_sizeinteger每页数量(最大50)

请求示例

json
{
  "wechat_user_space_id": 20401682,
  "page": 1,
  "page_size": 10,
  "coupon_type": 2
}

响应参数

参数必选类型描述
codeinteger状态码:200-成功,400-失败
msgstring提示信息
dataobject消息内容

data 参数结构

参数必选类型描述
totalinteger优惠券列表总数
listarray优惠券列表

list 参数结构

参数必选类型描述
coupon_idinteger优惠券id
coupon_namestring优惠券名称
coupon_typeinteger优惠券类型(1-随机立减券,2-满减券,3-折扣券,4-奖品兑换券)
coupon_descstring优惠信息描述
card_nostring优惠券编码
discount_moneyinteger优惠券金额
gtimeinteger领取时间
statusinteger优惠券状态 1:未使用;2:已占用;3:已使用;4已失效
start_timeinteger优惠券开始时间
end_timeinteger优惠券结束时间
is_verifyinteger优惠券使用时间
verify_nostring优惠券核销码

响应示例

json
{
  "code": 200,
  "data": {
    "total": 30,
    "list": [
      {
        "coupon_id": 2843,
        "coupon_name": "免费领取,线下核销免费领取,线下核销免费领取,线",
        "coupon_type": 4,
        "coupon_desc": "免费领取,线下核销免费领取,线下",
        "card_no": "1520730507060",
        "discount_money": "",
        "gtime": 1755681079,
        "status": 1,
        "start_time": 1755681079,
        "end_time": 2147483647,
        "is_verify": 2,
        "verify_no": "2419945807061"
      }
    ]
  },
  "msg": "Success"
}