Product Update Stock Qty API 文档
商品-批量更新-库存
接口信息
- 接口地址:
{your-site-url}/api/skill/product/update-stock-qty
- 基础 URL:
{your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/apimanager666
- 请求方式:
POST
- Content-Type:
application/json
- 说明: 此接口用于更新商品各规格的库存数量
认证
请求头中需要携带 skill-access-token：
| Header |
值 |
skill-access-token |
{your-skill-access-token} （请替换为你自己的 token） |
请求参数 (Body - JSON)
顶层字段
| 字段 |
类型 |
必填 |
说明 |
product_id |
int |
✅ 必填 |
产品 ID |
variant_stocks |
Array[Object] |
✅ 必填 |
各规格的库存数据数组 |
variant_stocks 子项字段
| 字段 |
类型 |
必填 |
说明 |
variant_id |
string |
条件必填 |
变体 ID。与 sku 至少有一个存在值，不可两者都为空 |
sku |
string |
条件必填 |
变体 SKU。与 variant_id 至少有一个存在值，不可两者都为空 |
qty |
int |
✅ 必填 |
变体库存数量。注意：该值为直接覆盖，非增量累加。更新后变体的库存将直接设置为该值 |
请求示例
cURL
curl --location --request POST '{your-site-url}/api/skill/product/update-stock-qty' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw '{
"product_id": 4932,
"variant_stocks": [
{
"variant_id": "",
"sku": "3232323-grey-L-1010805",
"qty": 333
},
{
"variant_id": "",
"sku": "3232323-grey-M-1010806",
"qty": 444
},
{
"variant_id": "",
"sku": "3232323-white-L-1010807",
"qty": 556
}
]
}'
通过 variant_id 更新示例
curl --location --request POST '{your-site-url}/api/skill/product/update-stock-qty' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw '{
"product_id": 4932,
"variant_stocks": [
{
"variant_id": "45140",
"sku": "",
"qty": 999
}
]
}'
返回结果
code 为 200 表示调用成功；code 不为 200 表示调用失败。
成功响应
{
"code": 200,
"message": "success"
}
返回字段说明
| 字段 |
类型 |
说明 |
code |
Number |
状态码，200 表示成功 |
message |
String |
执行结果的文字描述 |
注意事项
product_id 和 variant_stocks 均为必填variant_stocks 数组中每个子项的 variant_id 和 sku 至少有一个存在值，不可两者同时为空- 支持通过
variant_id 或 sku 定位目标变体，传其一即可
qty 为设置后的最终库存值，非增量