诺云开放平台

Appearance

用户优惠券列表 ​

请求路径 ​

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

请求参数 ​

参数名必选类型说明
wechat_user_space_id是integer用户id
coupon_type是integer优惠券类型 1 商品券 2 奖品兑换券
page是integer页码
page_size是integer每页数量（最大300）
gtime_start否integer领取时间起始（Unix时间戳），与gtime_end成对使用
gtime_end否integer领取时间结束（Unix时间戳），与gtime_start成对使用
sort_order否string排序方式：asc（升序）、desc（降序），默认 desc，按卡券记录ID排序

请求示例 ​

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

带领取时间筛选示例：

json
{
  "wechat_user_space_id": 20401682,
  "page": 1,
  "page_size": 10,
  "coupon_type": 2,
  "gtime_start": 1704067200,
  "gtime_end": 1735689599,
  "sort_order": "desc"
}

响应参数 ​

参数必选类型描述
code是integer状态码：200-成功，400-失败
msg是string提示信息
data是object消息内容

data 参数结构 ​

参数必选类型描述
total是integer优惠券列表总数
list是array优惠券列表

list 参数结构 ​

参数必选类型描述
id是integer优惠券领取记录ID（排序字段）
coupon_id是integer优惠券id
coupon_name是string优惠券名称
coupon_type是integer优惠券类型（1-随机立减券，2-满减券，3-折扣券，4-奖品兑换券）
coupon_desc是string优惠信息描述
card_no是string优惠券编码
discount_money是integer优惠券金额
gtime是integer领取时间
status是integer优惠券状态 1：未使用；2：已占用;3：已使用；4已失效
start_time是integer优惠券开始时间
end_time是integer优惠券结束时间
is_verify是integer核销码状态：1-已核销，2-未核销
verify_no是string优惠券核销码
order_id否integer使用该优惠券的订单ID，仅status=3（已使用）时有值

响应示例 ​

json
{
  "code": 200,
  "data": {
    "total": 30,
    "list": [
      {
        "id": 57513354,
        "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",
        "order_id": 0
      }
    ]
  },
  "msg": "Success"
}