/v2/providers/seller_api/apis/api/v1/marketplace/seller-products/time-framev1商品列表范围查询
简介
API支持的买家用户地区：韩国, 台湾 基于注册商品列表的 创建时间进行查看。 最长 查看范围为1 0 分钟。
详细内容
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