API支持的买家用户地区：韩国, 台湾
基于注册商品列表的创建时间进行查看。
最长查看范围为10分钟。
Path
GET
/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/time-frame
Example Endpoint
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
Request Parameters
Query String Parameter
| Name | Required | Type | Description | ||||
|---|---|---|---|---|---|---|---|
| vendorId | O | String | 卖家ID 酷澎分配给卖家的固有代码 ex) A00012345 | ||||
| createdAtFrom | O | String | 创建的开始时间 格式"yyyy-MM-ddTHH:mm:ss" ex) 2016-12-28T06:20:00 | ||||
| createdAtTo | O | String | 创建的结束时间 格式"yyyy-MM-ddTHH:mm:ss" 、ex) 2016-12-28T06:20:00 | ||||
Request Example
无请求体参数要求
Response Message
| Name | Type | Description | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| code | Number | 结果代码 SUCCESS/ERROR | ||||||||||||||||||||
| message | String | 结果信息 | ||||||||||||||||||||
| data | 注册商品列表 查看的卖家商品个数，重复N次 | |||||||||||||||||||||
| sellerProductId | Number | 注册商品ID | ||||||||||||||||||||
| sellerProductName | String | 注册商品名 搜索注册商品名，20字以内 | ||||||||||||||||||||
| displayCategoryCode | Number | 显示品类代码 | ||||||||||||||||||||
| vendorId | String | 卖家ID 酷澎分配给卖家的固有代码 ex) A00012345 | ||||||||||||||||||||
| saleStartedAt | String | 销售开始时间 格式"yyyy-MM-ddTHH:mm:ss" | ||||||||||||||||||||
| saleEndedAt | String | 销售结束时间 格式"yyyy-MM-ddTHH:mm:ss" | ||||||||||||||||||||
| brand | String | 品牌 输入正式的韩文/英文品牌名 | ||||||||||||||||||||
| statusName | String | 注册商品状态
| ||||||||||||||||||||
| createdAt | String | 注册销售的时间 格式"yyyy-MM-ddTHH:mm:ss" | ||||||||||||||||||||
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"
}
]
}Error Spec
| HTTP status code (error type) | Error message | How to resolve |
|---|---|---|
| 400 (check request parameter) | 卖家[A0012345] 无法搜索其他卖家 [skma***] 的商品列表。 | 查看卖家 ID (vendorId) 是否输入正确。 |
| 400 (check request parameter) | 超出搜索范围。最大范围为10 分钟。 | 查看输入的查询开始日期 (createdAtFrom) 和结束日期 (createdAtTo)是否正确。您最多可以在10 分钟内进行搜索。 |
URL API Name
GET_PRODUCTS_BY_TIME_FRAME