获取购物车列表接口

获取当前用户购物车中的商品列表,支持分页功能,返回商品详细信息及购物车相关数据。

注意事项

  • 接口支持登录用户和未登录用户(通过 cart token 识别)
  • 支持分页查询,可通过 current 和 pageSize 参数控制分页
  • 返回的商品信息包含购物车中的数量、价格等信息
  • total 字段返回购物车中商品的总数量

请求地址

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

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

请求语法

GET {域名地址}/api/cart/list?{参数}

请求头

字段名 类型 必填 说明
cart string 否 当没有登录的时候,用此token作为用户判断

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

请求参数

字段名 类型 必填 说明
current int 否 获取指定分页数据,当前页码
pageSize int 否 显示数量,每页数量

响应头

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

返回参数

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

data 结果 item 参数

字段名 类型 说明
id int 文档 ID
cart_id int 购物车ID
quantity int 数量
amount int 金额,单位分
origin_amount int 原始金额,单位分
order_extra object 订单扩展信息
is_wholesale bool 是否是批发商品
title string 文档标题
seo_title string 文档 SEO 标题
url_token string 文档 URL 别名
keywords string 文档关键词
description string 文档简介
module_id int 文档模型 ID
category_id int 文档分类 ID
views int 文档浏览量
comment_count int 文档评论量
images string[] 文档组图
logo string 文档 Logo
thumb string 文档缩略图
flag string 文档推荐属性,头条[h]推荐[c]幻灯[f]特荐[a]滚动[s]加粗[h]图片[p]跳转[j]
canonical_url string canonical url
fixed_link string 文档固定链接
created_time int 文档发布时间戳
updated_time int 文档更新时间戳
status int 文档显示状态
user_id int 用户 ID
price int 价格,单位分
stock int 库存量
user_id int 用户 ID

使用示例

请求示例

GET /api/cart/list?current=1&pageSize=20 HTTP/1.1
Host: your-domain.com
Content-Type: application/json

响应示例

{
  "code": 0,
  "data": [
    {
      "id": 1,
      "created_time": 1607308159,
      "updated_time": 1662717106,
      "title": "关于AnqiCMS",
      "seo_title": "",
      "url_token": "design",
      "keywords": "",
      "description": "安企内容管理系统(AnqiCMS),是一款使用 GoLang 开发的企业站内容管理系统,它部署简单,软件安全,界面优雅,小巧,执行速度飞快,使用 AnqiCMS 搭建的网站可以防止众多安全问题发生。",
      "module_id": 1,
      "category_id": 1,
      "views": 1338,
      "comment_count": 0,
      "images": null,
      "template": "",
      "status": 1,
      "canonical_url": "",
      "fixed_link": "",
      "flag": "",
      "user_id": 0,
      "price": 0,
      "stock": 9999999,
      "has_pseudo": 0,
      "keyword_id": 0,
      "origin_url": "",
      "origin_title": "",
      "category": null,
      "module_name": "",
      "data": null,
      "logo": "https://www.anqicms.com/uploads/202012/7/bd36c37ef742c7be.webp",
      "thumb": "https://www.anqicms.com/uploads/202012/7/thumb_bd36c37ef742c7be.webp",
      "extra": {
        "author": {
          "name": "作者",
          "value": "AnqiCMS",
          "default": null
        },
        "certificate": {
          "name": "学历",
          "value": null,
          "default": null
        },
        "city": {
          "name": "城市",
          "value": null,
          "default": null
        }
      },
      "link": "https://www.anqicms.com/design"
    }
  ],
  "msg": "",
  "total": 2
}

错误代码

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