Endpoint 目录
更新公开购物车 SKU 数量
PATCH /api/v1/open/storefront/carts/{cartId}/items/{skuId}
PATCH /api/v1/open/storefront/carts/{cartId}/items/{skuId}
- operationId:
updatePublicCartItemQuantity - 稳定性: candidate
- 认证:
Authorizationheader API Key；所需 scope：catalog:read - 幂等: required
参数
| 名称 | 位置 | 必需 | 类型 |
|---|---|---|---|
cartId | path | 是 | string |
skuId | path | 是 | string |
请求体
- 必需: 是
- Schema:
#/components/schemas/PublicCartQuantityUpdateRequest
响应与错误
| 状态 | 说明 | Schema |
|---|---|---|
200 | 操作成功 | #/components/schemas/PublicCartResponse |
400 | 请求不符合公开契约 | #/components/schemas/PublicErrorResponse |
401 | 认证失败 | #/components/schemas/PublicErrorResponse |
403 | 授权 scope 不足 | #/components/schemas/PublicErrorResponse |
404 | 公开资源不存在 | #/components/schemas/PublicErrorResponse |
409 | 幂等或状态冲突 | #/components/schemas/PublicErrorResponse |
429 | 请求频率受限 | #/components/schemas/PublicErrorResponse |
限流
spec 声明了 429 响应。
Retry-After header 未在 spec 中声明。
- 顶层结构:
{ data: object }
成功响应 Schema
{
"$ref": "#/components/schemas/PublicCartResponse"
}
错误响应 Schema
{
"$ref": "#/components/schemas/PublicErrorResponse"
}
本页由已验证 public-only OpenAPI artifact 生成；未提供推测性请求示例。