GET
/v2/providers/seller_api/apis/api/v1/marketplace/seller-productsv1상품 목록 페이징 조회
# 01
요약
API 적용 가능한 구매자 사용자 지역: 한국,대만 등록상품 목록을 페이징 조회한다.
# 02
상세
API 적용 가능한 구매자 사용자 지역: 한국,대만
등록상품 목록을 페이징 조회한다.
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
쿠팡에서 업체에게 발급한 고유 코드
예) A00012345 |
||||||||||||||||||||
| nextToken | Number |
페이지
다음 페이지를 호출하기 위한 키값. 첫 페이지 호출시에는 넣지 않거나 1 입력
|
|||||||||||||||||||||
| maxPerPage | Number |
페이지당건수
기본값 : 10, 최대값 :100
|
|||||||||||||||||||||
| sellerProductId | Number | 등록상품ID |
|||||||||||||||||||||
| sellerProductName | String |
등록상품명
등록상품명 검색. 20자 이하
|
|||||||||||||||||||||
| status | String |
업체상품상태
|
|||||||||||||||||||||
| manufacture | String | 제조사 |
|||||||||||||||||||||
| createdAt | String |
상품등록일시
"yyyy-MM-dd" 형식
예)2015-12-17과 같이 입력하면, 2015-12-17T00:00:00 ~ 2015-12-17T23:59:59 와 같이 조회됨
|
|||||||||||||||||||||
| ViolationTypeSearchField | List |
|
|||||||||||||||||||||
| ViolationTypeAndOr | String |
설명: "ViolationTypeSearchField" 필드에 2개 이상의 파라미터를 입력하는 경우 필수입니다. 값:
|
|||||||||||||||||||||
Request Example
not require body
Response Message
| Name | Type | Description | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| code | Number |
결과코드
SUCCESS/ERROR
|
||||||||||||||||||||
| message | String | 결과 메세지 |
||||||||||||||||||||
| nextToken | String |
다음페이지
만약 다음 페이지가 없을 경우 빈문자열
|
||||||||||||||||||||
| data | Array | |||||||||||||||||||||
| sellerProductId | String | 등록상품ID |
||||||||||||||||||||
| sellerProductName | String | 등록상품명 |
||||||||||||||||||||
| displayCategoryCode | Number | 노출카테고리코드 |
||||||||||||||||||||
| categoryId | Number | 카테고리아이디 |
||||||||||||||||||||
| productId | Number | ProductID |
||||||||||||||||||||
| 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 상태 코드 (오류 유형) | 오류 메시지 | 해결 방법 |
|---|---|---|
| 400 (요청변수확인) | 업체코드는 반드시 입력되어야 합니다. | 판매자 ID(vendorId) 값을 올바로 입력했는지 확인합니다. |
| 400 (요청변수확인) | Format of createdAt is `yyyy-MM-dd` | 상품등록일시(createdAt) 값을 올바른 형식으로 입력했는지 확인합니다. "yyyy-MM-dd" 형식으로 입력합니다. |
URL API Name
GET_PRODUCTS_BY_QUERY