添加购物车接口

将指定商品添加到购物车中,支持指定商品 SKU、数量等信息,适用于电商功能中的购物车操作。

注意事项

  • 该接口采用POST方法,需要以application/json格式提交数据
  • 支持登录用户和未登录用户(通过 cart token 识别)
  • 必须指定商品 ID 和数量
  • 可以通过 SKU ID 指定具体的商品规格
  • 如果商品已经在购物车中,则会更新数量而不是新增

请求地址

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

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

请求语法

POST {域名地址}/api/cart/add
Content-Type: application/json

请求头

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

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

请求参数

| 字段名 | 类型 | 必填| 说明 |

archive_id int
sku_id int
quantity int
status int
priority int
order_extra object

响应头

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

返回参数

字段名 类型 说明
code int 错误码
msg string 错误原因说明

使用示例

请求示例

POST /api/cart/add HTTP/1.1
Host: www.anqicms.com
Content-Type: application/json

{
  "archive_id": 1,
  "sku_id": 1,
  "quantity": 2,
  "order_extra": {
    "gift_wrapping": true,
    "message": "生日快乐"
  }
}

响应示例

{
  "code": 0,
  "msg": "保存成功"
}

错误代码

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