GET
/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/time-framev1產品清單區間查詢
# 01
簡介
消費者市場：韓國、台灣 依據建立日期／時間查詢產品清單。 查詢的最大時間區間為 10 分鐘。
# 02
詳細內容
消費者市場：韓國、台灣
依據建立日期／時間查詢產品清單。
查詢的最大時間區間為 10 分鐘。
通路
GET
/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/time-frame
請求範例端點
https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/time-frame?vendorId=A00012345&createdAtFrom=2020-02-19T10:43:30&createdAtTo=2020-02-19T10:50:30
參數需求
主體參數
| 名稱 | 必填 | 類型 | 說明 | ||||
|---|---|---|---|---|---|---|---|
| vendorId | O | String |
賣家 ID Coupang 核發給廠商的唯一代碼 例如：A00012345 |
||||
| createdAtFrom | O | String |
查詢起始時間 格式為 "yyyy-MM-ddTHH:mm:ss" 例如：2025-12-28T06:20:00 |
||||
| createdAtTo | O | String |
查詢截止時間 格式為 "yyyy-MM-ddTHH:mm:ss" 例如：2025-12-28T06:20:00 |
||||
請求示例
不要求請求參數
回應訊息
| 欄位名稱 | 類型 | 說明 | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| code | Number |
結果代碼
SUCCESS/ERROR
|
||||||||||||||||||||
| message | String | 結果訊息 |
||||||||||||||||||||
| data |
已上架商品列表： 根據供應商商品數量重複 N 次 |
|||||||||||||||||||||
| sellerProductId | Number |
賣家商品 ID
|
||||||||||||||||||||
| sellerProductName | String | 賣家商品名稱：搜尋已上架商品名稱，限 20 個字元以內 | ||||||||||||||||||||
| displayCategoryCode | Number | 展示類目代碼 |
||||||||||||||||||||
| vendorId | String |
供應商 ID (賣家代號)： 由 Coupang 核發給供應商的唯一代碼 範例： |
||||||||||||||||||||
| saleStartedAt | String |
販售開始時間 (格式：yyyy-MM-ddTHH:mm:ss) |
||||||||||||||||||||
| saleEndedAt | String |
販售結束時間 (格式：yyyy-MM-ddTHH:mm:ss) |
||||||||||||||||||||
| brand | String |
品牌名稱： 須為官方韓文或英文名稱 |
||||||||||||||||||||
| statusName | String |
已上架商品狀態名稱
|
||||||||||||||||||||
| createdAt | String |
商品上架日期/時間 (格式： |
||||||||||||||||||||
Response Example
{
"code": "SUCCESS",
"message": "",
"data": [
{
"sellerProductId": 123,
"sellerProductName": "[인xx] 컴퓨터잡지",
"displayCategoryCode": null,
"categoryId": 5555,
"productId": 3333,
"vendorId": "A0xxxxx",
"mdId": "jxxx@",
"mdName": "박xxx",
"saleStartedAt": "2015-12-28T06:00:00",
"saleEndedAt": "2099-01-01T00:00:00",
"brand": null,
"statusName": "승인완료",
"createdAt": "2015-12-28T18:57:34"
}
]
}錯誤規格
| HTTP 狀態碼 (error type) | 錯誤訊息 | 解決方法 |
|---|---|---|
| 400 (檢查請求參數) | 供應商 [A0012345] 無法查詢另一家供應商 [skma***] 的商品列表 | 請檢查賣家 ID (vendorId) 是否正確。 |
| 400 (檢查請求參數) | 已超過最大搜尋範圍。最大範圍為 10 分鐘 |
請檢查查詢開始日期 (createdAtFrom) 與結束日期 (createdAtTo) 是否正確。您最多只能查詢 10 分鐘內 的資料。 |
URL API Name
GET_PRODUCTS_BY_TIME_FRAME