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}®istrationType={registrationType}
Request Parameters
Query String Parameter
| Name | Required | Type | Description | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| vendorId | O | String |
卖家ID 酷澎分配给卖家的固有代码 ex) C00012345
|
||||||||||||||||||||
| registrationType | String |
注册类型 |
|||||||||||||||||||||
| 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 |
|||||||||||||||||||||
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