Path
GET
/v2/providers/seller_api/apis/api/v1/marketplace/seller-products
Example Endpoint
https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/seller-products?vendorId={vendorId}&nextToken={nextToken}&maxPerPage={maxPerSize}&sellerProductId={sellerProductId}&sellerProductName={sellerProductName}&status={status}&manufacture={manufacture}&createdAt={createdAt}&violationTypes=ATTR&violationTypes=MOTA_V2&violationTypeAndOr=OR
Request Parameters
Query String Parameter
| Name | Required | Type | Description | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| vendorId | O | String | 卖家ID 酷澎分配给卖家的固有代码 ex) C00012345 | ||||||||||||||||||||
| nextToken | Number | 页面 调用下一页的关键值 调用第一页时，不要输入或输入'1' | |||||||||||||||||||||
| maxPerPage | Number | 每页件数 默认值：10；最大值: 100 | |||||||||||||||||||||
| sellerProductId | Number | 注册商品ID | |||||||||||||||||||||
| sellerProductName | String | 注册商品名 搜索注册商品名，20字以内 | |||||||||||||||||||||
| status | String | 卖家商品状态
| |||||||||||||||||||||
| manufacture | String | 制造商 | |||||||||||||||||||||
| createdAt | String | 商品注册时间 格式"yyyy-MM-dd" Ex) Type in "2015-12-17" to query 2015-12-17T00:00:00 ~ 2015-12- 17T23:59:59 | |||||||||||||||||||||
| ViolationTypeSearchField | List |
| |||||||||||||||||||||
| ViolationTypeAndOr | String | 逻辑关系 (Logical Operator)
| |||||||||||||||||||||
Request Example
Response Message
| Name | Type | Description | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| code | Number | 结果代码 SUCCESS/ERROR | ||||||||||||||||||||
| message | String | 结果信息 | ||||||||||||||||||||
| nextToken | String | 下一页 若无下页，则为空字符 | ||||||||||||||||||||
| data | Array | |||||||||||||||||||||
| sellerProductId | String | 注册商品ID | ||||||||||||||||||||
| sellerProductName | String | 注册商品名 | ||||||||||||||||||||
| displayCategoryCode | Number | 显示品类代码 | ||||||||||||||||||||
| categoryId | Number | 品类ID | ||||||||||||||||||||
| productId | Number | 商品ID | ||||||||||||||||||||
| vendorId | String | 卖家ID | ||||||||||||||||||||
| 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": "",
"nextToken": "2",
"data": [
{
"sellerProductId": 239092172,
"sellerProductName": "R07 헬로키티 미니낚시놀이",
"displayCategoryCode": 77413,
"categoryId": 2102,
"productId": 14784194,
"vendorId": "XXXXXXXX",
"mdId": "harry867@",
"mdName": null,
"saleStartedAt": "2017-02-14T06:00:00",
"saleEndedAt": "2099-12-31T00:00:00",
"brand": "상세설명별도참조",
"statusName": "승인완료",
"createdAt": "2017-02-13T02:09:47"
},
{
"sellerProductId": 239092161,
"sellerProductName": "R07 러닝리소스 손가락 지시봉 (10개 세트) (LER2657) - 러닝리소스 지시봉 손가락 포인터 장난감",
"displayCategoryCode": 77413,
"categoryId": 2102,
"productId": 14784126,
"vendorId": "XXXXXXXX",
"mdId": "harry867@",
"mdName": null,
"saleStartedAt": "2017-02-14T06:00:00",
"saleEndedAt": "2099-12-31T00:00:00",
"brand": "상세설명별도참조",
"statusName": "승인완료",
"createdAt": "2017-02-13T02:09:46"
}
]
}Error Spec
| HTTP status code (error type) | Error message | How to resolve |
|---|---|---|
| 400 (check request parameter) | 卖家代码必须输入。 | 查看卖家 ID (vendorId) 是否输入正确。 |
| 400 (check request parameter) | createdAt的格式是`yyyy- MM-dd` | 查看输入的商品注册日期 (createdAt) 值是否输入正确。格式要为“yyyy-MM-dd”。 |
URL API Name
GET_PRODUCTS_BY_QUERY