获取愿望清单列表接口

    获取当前登录用户的愿望清单列表,支持分页查询,返回用户收藏的商品信息。

    注意事项

    • 该接口采用GET方法,无需请求体
    • 需要用户已登录,通过会话或Token验证身份
    • 支持分页查询,可通过参数控制每页显示数量和当前页码
    • 返回愿望清单中商品的详细信息,包括价格、备注等
    • 包含商品当前价格和添加时的价格对比

    请求地址

    {域名地址}/api/wishlist/list
    

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

    请求语法

    GET {域名地址}/api/wishlist/list
    

    请求头

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

    请求参数

    字段名 类型 必填 说明
    current int 否 当前页码,默认为1
    pageSize int 否 每页显示数量,默认为10

    响应头

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

    返回参数

    字段名 类型 说明
    code int 错误码
    msg string 错误原因说明
    data array 愿望清单数据列表
    total int 愿望清单总数量

    data 数组元素参数

    字段名 类型 说明
    id int 愿望清单记录ID
    user_id int 用户ID
    user_name string 用户名
    archive_id int 商品ID
    sku_id int SKU ID
    title string 商品名称
    sku_title string 商品SKU名称
    description string 商品描述
    remark string 用户备注
    thumb string 商品缩略图URL
    link string 商品链接
    price int 商品当前价格
    origin_price int 添加时的商品价格
    target_price int 用户设定的愿望价格
    status int 记录状态(如:是否可用)
    priority int 优先级
    created_time int 添加时间戳

    使用示例

    请求示例

    GET /api/wishlist/list?current=1&pageSize=10 HTTP/1.1
    Host: www.anqicms.com
    

    响应示例

    {
      "code": 0,
      "msg": "",
      "data": [
        {
          "id": 1,
          "user_id": 1001,
          "user_name": "张三",
          "archive_id": 123,
          "sku_id": 456,
          "title": "iPhone 13",
          "sku_title": "iPhone 13 128G 蓝色",
          "description": "苹果最新款智能手机",
          "remark": "生日礼物",
          "thumb": "https://www.anqicms.com/uploads/images/iphone13.jpg",
          "link": "https://www.anqicms.com/product/123",
          "price": 599900,
          "origin_price": 699900,
          "target_price": 550000,
          "status": 1,
          "priority": 1,
          "created_time": 1640995200
        },
        {
          "id": 2,
          "user_id": 1001,
          "user_name": "张三",
          "archive_id": 124,
          "sku_id": 457,
          "title": "MacBook Pro",
          "sku_title": "MacBook Pro 14寸 银色",
          "description": "苹果专业笔记本电脑",
          "remark": "工作用",
          "thumb": "https://www.anqicms.com/uploads/images/macbook.jpg",
          "link": "https://www.anqicms.com/product/124",
          "price": 1499900,
          "origin_price": 1599900,
          "target_price": 1399900,
          "status": 1,
          "priority": 2,
          "created_time": 1640995300
        }
      ],
      "total": 2
    }
    

    错误请求示例

    GET /api/wishlist/list HTTP/1.1
    Host: www.anqicms.com
    Authorization: Bearer invalid_token
    

    错误响应示例

    {
      "code": 1001,
      "msg": "未登录"
    }
    

    错误代码

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