韩国本地火箭仓库存API（Rocket Growth Inventory Summary API）可让您以编码开发对接方式检索酷澎物流网络中的火箭仓商品库存信息。
返回库存摘要列表。所返回的摘要取决于是否存在vendorIdItemId参数：
- 省略vendorIdItemId参数时，将返回所有具有可用详细信息的库存摘要。
- 如果提供了vendorIdItemId参数，操作将只返回指定的vendorIdItemId的库存摘要。nextToken参数将被忽略。如果提供了vendorId和nextToken参数，操作将返回从nextToken开始的所有库存的库存摘要。
特别注意：调用此API频次请控制在每分钟50次内，否则会导致过频请求报错
Path
GET
/v2/providers/rg_open_api/apis/api/v1/vendors/{vendorId}/rg/inventory/summaries
Example Endpoint
https://api-gateway.coupang.com/v2/providers/rg_open_api/apis/api/v1/vendors/{vendorId}/rg/inventory/summaries
Request Parameters
Path Segment Parameter
| Name | Required | Type | Description | ||||
|---|---|---|---|---|---|---|---|
| vendorId | O | String |
卖家id
|
||||
| vendorItemId | String |
用于查询指定卖家SKU库存摘要的单个vendorItemId
|
|||||
| nextToken |
String |
您上一个请求响应中返回的字符串翻页令牌（String token）。
|
|||||
Request Example
无请求体参数要求
Response Message
| Name | Type | Description | ||||
|---|---|---|---|---|---|---|
| code | String |
结果代码 SUCCESS/ERROR |
||||
| message | String |
结果信息 |
||||
| data | List |
有效信息 |
||||
| vendorId | String |
卖家ID 酷澎分配给卖家的固有代码 |
||||
| vendorItemId | String |
销售开始时间 格式"yyyy-MM-dd'T'HH:mm:ss" |
||||
externalSkuId |
String |
销售结束时间 格式"yyyy-MM-dd'T'HH:mm:ss," *年份最多设置到2099年 |
||||
inventoryDetails |
特定sku的库存详情。 |
|||||
|
|
Integer | 商品的可订购单位总数。 | ||||
salesCountMap
|
出售信息 | |||||
SALES_COUNT_LAST_THIRTY_DAYS |
Integer | 过去30天卖了多少 | ||||
nextToken |
String |
翻页标签 |
||||
Response Example
{ "code": 200, "message": "SUCCESS", "data": [ { "vendorId": "A00123456", "vendorItemId": 70000000000, "externalSkuId": 10012345, "inventoryDetails": { "totalOrderableQuantity": 10 }, "salesCountMap": { "SALES_COUNT_LAST_THIRTY_DAYS": 15 } }, { "vendorId": "A00123456", "vendorItemId": 70000000001, "externalSkuId": 10012346, "inventoryDetails": { "totalOrderableQuantity": 20 }, "salesCountMap": { "SALES_COUNT_LAST_THIRTY_DAYS": 25 } } ], "nextToken": "2"} |
Error Spec
| HTTP status code (error type) | Error message | How to resolve |
|---|---|---|
|
400 |
Request has missing or invalid parameters and cannot be parsed.
|
请求缺少参数或者参数无效，无法解析。填写必要参数 |
|
429 |
Too Many Requests |
请求太频繁 |
URL API Name