获取愿望清单列表接口

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

注意事项

  • 该接口采用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