商品总库存列表

提供商品库存查询能力，支持批量查询多个SKU的总库存信息，支持分页获取结果。

适用场景

批量查询商品库存数量

获取商品库存基本信息（名称、SKU、库存数）

接口类型

POST

请求频率限制

默认频率：以平台配额为准

请求说明

请求URL

正式环境：https://www.westmonth.com/openapi/inventory/query
测试环境：https://testing.westmonth.com/openapi/inventory/query

请求参数

Header参数

参数名	类型	必填	示例值	说明
Authorization	string	是	authorization	身份验证Token
Content-Type	string	是	application/json	建议固定传此值

Body参数

根字段

参数名	类型	必填	默认值	可选值	说明
skus	string	是	-	-	商品SKU集合，多个SKU用英文逗号隔开
page	integer	是	-	-	页码（从1开始）
size	integer	是	-	-	每页展示数量

响应字段说明

成功响应（HTTP 200）

根字段

字段	类型	说明
code	integer	业务状态码（0表示成功）
msg	string	提示信息（成功时返回"执行成功"）
data	object	业务数据

data对象字段

字段	类型	说明
page	integer	当前页码
size	integer	每页展示数量
data_count	integer	总数据量
page_count	integer	总页数
has_next	boolean	是否有下一页（true：有，false：无）
list	array	库存信息列表

list数组字段

字段	类型	说明
sku	string	商品SKU编码
name	string	商品名称
quantity	integer	商品总库存数量

调用示例

URL请求

请求示例

{
    "skus": "EEA02-A142-4-YE1,EEA02-A143-20-VT1,EEA02-A144-30-WH1",
    "page": 1,
    "size": 50
}

成功返回示例

{
    "code": 0,
    "msg": "执行成功",
    "data": {
        "page": 1,
        "size": 3,
        "data_count": 3,
        "page_count": 50,
        "has_next": false,
        "list": [
            {
                "sku": "EEA02-A142-4-YE1",
                "name": "EELHOE 维生素C眼霜棒 黑眼圈修护滋润紧致眼霜棒",
                "quantity": 0
            },
            {
                "sku": "EEA02-A143-20-VT1",
                "name": "EELHOE 烟酰胺精华 护肤提拉淡斑抗皱精华",
                "quantity": 0
            },
            {
                "sku": "EEA02-A144-30-WH1",
                "name": "EELHOE 抗皱面部精华 淡斑补水抗皱防衰老精华",
                "quantity": 0
            }
        ]
    }
}

失败返回示例

{
    "code": 3,
    "msg": "授权无效 authorization timestamp error",
    "data": []
}

错误处理

公共错误码

HTTP status code	错误码	错误信息	描述

注意事项

本接口仅返回商品总库存，不支持精确到仓库或发货区域的库存查询

sku参数最多支持一次性查询100个SKU，超过数量可能导致查询失败

分页参数page和size需配合使用，建议size取值范围为10-100

常见问题

Q1：如何批量查询多个SKU的库存？

A：在skus参数中传入多个SKU，用英文逗号分隔即可，例如："EEA02-A142-4-YE1,EEA02-A143-20-VT1"。

Q2：查询结果中的quantity为0表示什么？

A：表示该商品当前无库存。

Q3：如何判断是否有更多库存数据？

A：通过data对象中的has_next字段判断，true表示有下一页，可通过增加page参数值获取更多数据。

版本历史

版本	日期	修改说明
v1.0	2025-01-01	初始版本

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "msg": "执行成功",
    "data": {
        "page": 1,
        "size": 50,
        "data_count": 28341,
        "page_count": 50,
        "has_next": true,
        "list": [
            {
                "sku": "HOA02-A007-30-GN1",
                "name": "Hoygi 胶原蛋白精华 淡纹补水紧致抗皱精华",
                "quantity": 0
            },
            {
                "sku": "WEA02-A039-10-WH1",
                "name": "West&Month 胶原蛋白膜 抗皱补水紧致焕白贴",
                "quantity": 1025
            },
            {
                "sku": "WEA02-A038-20-BU1",
                "name": "West&Month 眼霜 淡纹修护滋润紧致眼霜",
                "quantity": 457
            },
            {
                "sku": "WEA03-A058-60-WH1",
                "name": "West&Month 脱毛霜 温和清洁嫩肤脱毛霜",
                "quantity": 46
            },
            {
                "sku": "WEA02-A037-100-WH1",
                "name": "West&Month 身体焕白霜 袪黑焕白补水美肤霜",
                "quantity": 232
            },
            {
                "sku": "EEA02-A135-100-GY1",
                "name": "EELHOE 火山泥清洁泥膜 紧致清洁保湿去黑头粉刺泥膜",
                "quantity": 0
            },
            {
                "sku": "WEA03-A057-30-PK1",
                "name": "West&Month 提臀霜 按摩紧致滋润美臀霜",
                "quantity": 460
            },
            {
                "sku": "JAA02-A055-30-BU1",
                "name": "Jaysuing 水光芋螺肽抗皱精华液 淡纹滋润提亮嫩肤液",
                "quantity": 11
            },
            {
                "sku": "WEA03-A056-100-PK1",
                "name": "West&Month美胸霜 紧实坚挺凸显身体曲线肌肤光滑丰盈紧致按摩霜",
                "quantity": 87
            },
            {
                "sku": "HOA02-A005-30-GD1",
                "name": "Hoygi 皮肤精华 淡化细纹紧致肌肤焕亮嫩肤滋润补水保湿精华",
                "quantity": 137
            },
            {
                "sku": "JAA02-A056-50-PK1",
                "name": "Jaysuing 胶原蛋白视黄醇面霜 亮肤滋润焕白抗皱面霜",
                "quantity": 7
            },
            {
                "sku": "EEA02-A139-50-WH1",
                "name": "EELHOE 洁面膏 卸妆焕亮滋润洁净膏",
                "quantity": 0
            },
            {
                "sku": "OUA02-A040-30-WH1",
                "name": "OUHOE 防衰老精华素 抗皱滋润紧致防衰老精华",
                "quantity": 89
            },
            {
                "sku": "EEA02-A138-30-BU1",
                "name": "EELHOE 防衰老精华液 保湿修护焕亮抗初老精华",
                "quantity": 1303
            },
            {
                "sku": "OUA02-A039-30-WH1",
                "name": "OUHOE 胶原蛋白面部精华素 抗皱滋润紧致防衰老精华",
                "quantity": 85
            },
            {
                "sku": "EEA02-A137-1-WH1",
                "name": "EELHOE 黑头鼻膜膏 鼻头清洁滋润护理套装",
                "quantity": 6
            },
            {
                "sku": "HOA02-A006-30-WH1",
                "name": "Hoygi 防衰老精华素 亮肤滋润紧致防衰老精华",
                "quantity": 93
            },
            {
                "sku": "WEA03-A055-60-WH1",
                "name": "West&Month 焕白皂 亮肤清洁滋润沐浴皂",
                "quantity": 59
            },
            {
                "sku": "WEA03-A054-100-OG1",
                "name": "West&Month 焕白维生素C皂 亮肤滋润沐浴清洁皂",
                "quantity": 171
            },
            {
                "sku": "EEA02-A133-120-VT1",
                "name": "EELHOE 紫苏冰晶保湿凝胶 修护淡化痘印清洁保湿凝胶",
                "quantity": 0
            },
            {
                "sku": "WEA02-A040-10-WH1",
                "name": "West&Month 抗皱精华 补水紧致护肤抗皱精华液",
                "quantity": 557
            },
            {
                "sku": "HOA02-A008-50-YE1",
                "name": "Hoygi 视黄醇防衰老面霜 提亮焕白补水易吸收面霜",
                "quantity": 385
            },
            {
                "sku": "EEA02-A140-30-WH1",
                "name": "EELHOE 防衰老焕白维C精华 紧致补水焕白抗皱精华",
                "quantity": 154
            },
            {
                "sku": "JAA02-A057-30-VT1",
                "name": "Jaysuing 抗皱保湿精华 淡纹亮肤补水紧致精华",
                "quantity": 302
            },
            {
                "sku": "OUA02-A038-15-SR1",
                "name": "OUHOE 保湿眼霜 修护紧致补水抗皱眼霜",
                "quantity": 390
            },
            {
                "sku": "EEA03-A220-150-OG1",
                "name": "EELHOE 磨砂膏 清洁去角质补水焕白磨砂膏",
                "quantity": 522
            },
            {
                "sku": "HOA02-A004-120-OG1",
                "name": "Hoygi 24K金肽逆转精华液 保湿抗皱紧致抗初老精华",
                "quantity": 1097
            },
            {
                "sku": "HOA02-A003-120-YE1",
                "name": "Hoygi 人参精华 紧致亮肤补水抗皱精华",
                "quantity": 244
            },
            {
                "sku": "WEA03-A053-30-WH1",
                "name": "West&Month 胸部精油 紧致丰盈美胸护理精油",
                "quantity": 442
            },
            {
                "sku": "JAA02-A053-70-OG1",
                "name": "Jaysuing 紧致护理面霜 滋润紧致淡化细纹斑点柔嫩焕亮肌肤面霜",
                "quantity": 4512
            },
            {
                "sku": "JAA03-A043-80-YE1",
                "name": "Jaysuing 提臀霜 紧致丰盈滋润提臀霜",
                "quantity": 0
            },
            {
                "sku": "EEA03-A219-200-PK1",
                "name": "EELHOE 石榴身体磨砂膏 清洁去角质嫩肤滋润磨砂膏",
                "quantity": 93
            },
            {
                "sku": "EEA02-A131-70-OG1",
                "name": "EELHOE 抗皱面霜 滋润淡斑焕亮抗皱面霜",
                "quantity": 126
            },
            {
                "sku": "EEA03-A218-150-YE1",
                "name": "EELHOE 提臀霜 按摩紧致滋润美臀霜",
                "quantity": 3
            },
            {
                "sku": "EEA03-A218-150-PK1",
                "name": "EELHOE 提臀霜 按摩紧致滋润美臀霜",
                "quantity": 91
            },
            {
                "sku": "EEA02-A129-30-GN1",
                "name": "EELHOE 虫草眼霜 抗皱补水提亮护理眼霜",
                "quantity": 74
            },
            {
                "sku": "EEA02-A126-30-BU1",
                "name": "EELHOE 防衰老乳液 紧致补水抗皱防衰老乳液",
                "quantity": 603
            },
            {
                "sku": "JAA02-A052-15-BK1",
                "name": "Jaysuing 草本精华液 淡斑紧致提亮滋润精华液",
                "quantity": 350
            },
            {
                "sku": "OUA03-A069-50-WH1",
                "name": "OUHOE 美胸霜 坚挺滋润护理美乳霜",
                "quantity": 0
            },
            {
                "sku": "EEA03-A217-30-WH1",
                "name": "EELHOE 天然化斑霜 淡斑补水焕白提亮霜",
                "quantity": 599
            },
            {
                "sku": "WEA02-A034-15-BU1",
                "name": "West&Month 视黄醇眼霜 黑眼圈修护滋润紧致眼霜",
                "quantity": 225
            },
            {
                "sku": "EEA02-A144-30-WH1",
                "name": "EELHOE 抗皱面部精华 淡斑补水抗皱防衰老精华",
                "quantity": 333
            },
            {
                "sku": "EEA02-A143-20-VT1",
                "name": "EELHOE 烟酰胺精华 护肤提拉淡斑抗皱精华",
                "quantity": 467
            },
            {
                "sku": "EEA02-A142-4-YE1",
                "name": "EELHOE 维生素C眼霜棒 黑眼圈修护滋润紧致眼霜棒",
                "quantity": 3004
            },
            {
                "sku": "JAA02-A058-30-BU1",
                "name": "Jaysuing 防衰老面部精华 紧致淡纹保湿防衰老精华",
                "quantity": 138
            },
            {
                "sku": "OUA02-A037-50-OG1",
                "name": "OUHOE 亮肤精华素 提亮滋润袪黑美肤精华",
                "quantity": 291
            },
            {
                "sku": "ajt114yy01-一袋12pcs",
                "name": "South Moon 瘦臂艾灸贴 热敷燃烧脂肪减肥贴片",
                "quantity": 824
            },
            {
                "sku": "amg414yx01-E款50g盒装",
                "name": "EELHOE 生姜减肥霜 纤体燃脂身体减肥霜",
                "quantity": 1358
            },
            {
                "sku": "bns214yx01-40ml",
                "name": "Jaysuing 玻尿酸护手精华 玻尿酸抗衰老护肤保湿精华液",
                "quantity": 88
            },
            {
                "sku": "bt1216yx01-30g",
                "name": "West&Month 去除黑头面膜 撕拉式去黑头活性炭清洁面膜",
                "quantity": 1739
            }
        ]
    }
}

商品总库存列表

商品总库存列表#

适用场景#

接口类型#

请求频率限制#

请求说明#

请求参数#

Header参数#

Body参数#

响应字段说明#

调用示例#

URL请求#

请求示例#

成功返回示例#

失败返回示例#

错误处理#

注意事项#

常见问题#

Q1：如何批量查询多个SKU的库存？#

Q2：查询结果中的quantity为0表示什么？#

Q3：如何判断是否有更多库存数据？#

版本历史#

请求参数

请求示例代码

返回响应

商品总库存列表

适用场景

接口类型

请求频率限制

请求说明

请求参数

Header参数

Body参数

响应字段说明

调用示例

URL请求

请求示例

成功返回示例

失败返回示例

错误处理

注意事项

常见问题

Q1：如何批量查询多个SKU的库存？

Q2：查询结果中的quantity为0表示什么？

Q3：如何判断是否有更多库存数据？

版本历史