获取我的优惠券列表接口

    获取当前用户已领取的优惠券列表,支持分页显示和状态筛选功能。

    注意事项

    • 该接口用于获取当前用户的优惠券列表信息
    • 支持分页查询,可通过current和pageSize参数控制分页
    • 支持按状态筛选优惠券(未使用、已使用或全部)
    • 需要用户登录后才能获取优惠券列表
    • 需要确保域名地址正确配置
    • 返回结果包含总数信息,便于前端分页处理

    请求地址

    {域名地址}/api/coupon/codes
    

    说明:{域名地址} 需要替换成你的域名地址,如 https://www.anqicms.com/api/coupon/codes

    请求语法

    GET /api/coupon/codes
    

    请求头

    此接口仅涉及公共请求头。更多信息,请参见公共请求头(Common Request Headers)。

    请求参数

    字段名 类型 必填 说明
    current int 否 获取指定分页数据,当前页码
    pageSize int 否 显示数量,每页数量
    status int 否 状态 0 = 未使用,1 = 已使用, 不传,获取全部

    响应头

    此接口仅涉及公共相应头。更多信息,请参见公共请求头(Common Request Headers)。

    返回参数

    字段名 类型 说明
    code int 错误码
    msg string 错误原因说明
    data object[] 结果内容
    total int 总数

    data 结果 item 参数

    字段名 类型 说明
    id int 优惠券码ID
    title string 优惠券名称
    coupon_id int 优惠券ID
    start_time int 开始时间
    end_time int 结束时间
    user_id int 用户ID
    money float 优惠金额
    max_money float 最高优惠金额
    get_time int 领取时间
    use_time int 使用时间
    order_id int 订单ID
    money_type int 优惠金额类型 0 = 固定金额,1=随机金额,2=百分比折扣
    description string 描述

    使用示例

    请求示例

    GET /api/coupon/codes?current=1&pageSize=10&status=0 HTTP/1.1
    Host: www.anqicms.com
    

    响应示例

    {
      "code": 0,
      "data": [
        {
          "id": 1,
          "title": "新用户优惠券",
          "coupon_id": 1,
          "start_time": 1624494644,
          "end_time": 1627173044,
          "user_id": 1,
          "money": 10.00,
          "max_money": 0.00,
          "get_time": 1624494644,
          "use_time": 0,
          "order_id": 0,
          "money_type": 0,
          "description": "新用户专享优惠券"
        },
        {
          "id": 2,
          "title": "满减优惠券",
          "coupon_id": 2,
          "start_time": 1624494644,
          "end_time": 1627173044,
          "user_id": 1,
          "money": 20.00,
          "max_money": 0.00,
          "get_time": 1624494650,
          "use_time": 0,
          "order_id": 0,
          "money_type": 0,
          "description": "满100可用"
        }
      ],
      "msg": "",
      "total": 2
    }
    

    错误码

    错误码 说明
    0 OK
    -1 错误,错误原因在 msg 中指出
    1001 未登录
    1002 未授权
    200 API 请求 OK