GET
/v2/providers/seller_api/apis/api/v1/marketplace/meta/display-categories/{displayCategoryCode}2609170000카테고리 조회
KRTW
# 01
요약
카테고리 조회
# 02
상세
API 적용 가능한 구매자 사용자 지역: 한국
카테고리 정보를 노출 카테고리 코드(displayCategoryCode)를 이용하여 조회한다.
1 Depth 카테고리 정보 조회는 노출카테고리코드 값을 0으로 설정 후 호출합니다.
경로
GET/v2/providers/seller_api/apis/api/v1/marketplace/meta/display-categories/{displayCategoryCode}
예시 엔드포인트
https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/meta/display-categories/0# 03
Path 파라미터
| Name | Type | Description |
|---|---|---|
| displayCategoryCode* | string | 노출카테고리코드
|
# 04
응답 본문
응답 메시지
| Name | Type | Description | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| code | string | 결과코드 SUCCESS/ERROR | ||||||||
| message | string | 메세지
| ||||||||
| data | object | 노출카테고리목록 조회된 노출 카테고리 개수만큼 N번 반복 | ||||||||
| displayItemCategoryCode data.displayItemCategoryCode | integer | |||||||||
| name data.name | string | 노출카테고리명
| ||||||||
| status data.status | string | 노출카테고리상태
| ||||||||
| child data.child | object[] | 하위노출카테고리 조회된 카테고리 코드의 1 Depth 하위 카테고리 List 표시.(2 Depth 이상의 child 는 표시하지 않음.) child 카테고리가 없을 경우 null 또는 빈 배열 반환 1 Depth 카테고리 조회는 displayCategoryCode 파라메터 값을 0으로 설정하면 가능합니다. | ||||||||
| displayItemCategoryCode data.child[].displayItemCategoryCode | integer | |||||||||
| name data.child[].name | string | |||||||||
| status data.child[].status | string | |||||||||
| child data.child[].child | object[] |
Response Example
{
"code": "SUCCESS",
"message": "",
"data": {
"displayItemCategoryCode": 0,
"name": "ROOT",
"status": "ACTIVE",
"child": [
{
"displayItemCategoryCode": 77834,
"name": "가구/홈데코",
"status": "ACTIVE",
"child": []
},
{
"displayItemCategoryCode": 62588,
"name": "가전/디지털",
"status": "ACTIVE",
"child": []
},
{
"displayItemCategoryCode": 66679,
"name": "도서",
"status": "ACTIVE",
"child": []
},
{
"displayItemCategoryCode": 79648,
"name": "문구/오피스",
"status": "ACTIVE",
"child": []
},
{
"displayItemCategoryCode": 65799,
"name": "반려/애완용품",
"status": "ACTIVE",
"child": []
},
{
"displayItemCategoryCode": 56112,
"name": "뷰티",
"status": "ACTIVE",
"child": []
},
{
"displayItemCategoryCode": 63897,
"name": "생활용품",
"status": "ACTIVE",
"child": []
},
{
"displayItemCategoryCode": 103371,
"name": "스포츠/레져",
"status": "ACTIVE",
"child": []
},
{
"displayItemCategoryCode": 59258,
"name": "식품",
"status": "ACTIVE",
"child": []
},
{
"displayItemCategoryCode": 102984,
"name": "완구/취미",
"status": "ACTIVE",
"child": []
},
{
"displayItemCategoryCode": 79138,
"name": "음반/DVD",
"status": "ACTIVE",
"child": []
},
{
"displayItemCategoryCode": 78647,
"name": "자동차용품",
"status": "ACTIVE",
"child": []
},
{
"displayItemCategoryCode": 80285,
"name": "주방용품",
"status": "ACTIVE",
"child": []
},
{
"displayItemCategoryCode": 76844,
"name": "출산/유아동",
"status": "ACTIVE",
"child": []
},
{
"displayItemCategoryCode": 69182,
"name": "패션의류잡화",
"status": "ACTIVE",
"child": []
}
]
}
}# 05
에러 코드
| HTTP | 코드 | 메시지 |
|---|---|---|
| 400 | HTTP_400 | Bad Request |
오류 사양
| HTTP | 유형 | 오류 메시지 | 해결 방법 |
|---|---|---|---|
| 400 | 400 (요청변수확인) | 전시카테고리[****]를 찾을 수 없습니다. 전시카테고리코드를 확인해 주세요. | 올바른 노출(전시)카테고리코드를 입력했는지 확인합니다. |
| 400 | 400 (요청변수확인) | 노출카테고리코드는 숫자형으로 입력해주세요. | 올바른 노출카테고리코드를 입력했는지 확인합니다. 노출카테고리코드는 숫자로만 입력 가능합니다. |