카테고리 정보를 노출 카테고리 코드(displayCategoryCode)를 이용하여 조회한다.
1 Depth 카테고리 정보 조회는 노출카테고리코드 값을 0으로 설정 후 호출합니다.
Path
GET
/v2/providers/seller_api/apis/api/v1/marketplace/meta/display-categories/{displayCategoryCode}
Example Endpoint
https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/meta/display-categories/0
Request Parameters
Path Segment Parameter
| Name | Required | Type | Description | ||||
|---|---|---|---|---|---|---|---|
| displayCategoryCode | O | String |
노출카테고리코드
|
||||
Request Example
not require body
Response Message
| Name | Type | Description | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| code | String |
결과코드
SUCCESS/ERROR
|
||||||||||||
| message | String |
메세지
|
||||||||||||
| data | Array |
노출카테고리목록
조회된 노출 카테고리 개수만큼 N번 반복
|
||||||||||||
| displayCategoryCode | String |
노출카테고리코드
|
||||||||||||
| name | String |
노출카테고리명
|
||||||||||||
| status | String |
노출카테고리상태
|
||||||||||||
| child | String |
하위노출카테고리
조회된 카테고리 코드의 1 Depth 하위 카테고리 List 표시.(2 Depth 이상의 child 는 표시하지 않음.) child 카테고리가 없을 경우 null 또는 빈 배열 반환
1 Depth 카테고리 조회는 displayCategoryCode 파라메터 값을 0으로 설정하면 가능합니다.
|
||||||||||||
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": []
}
]
}
}Error Spec
| HTTP 상태 코드(오류 유형) | 오류 메시지 | 해결 방법 |
|---|---|---|
| 400 (요청변수확인) | 전시카테고리[****]를 찾을 수 없습니다. 전시카테고리코드를 확인해 주세요. | 올바른 노출(전시)카테고리코드를 입력했는지 확인합니다. |
| 400 (요청변수확인) |
노출카테고리코드는 숫자형으로 입력해주세요. |
올바른 노출카테고리코드를 입력했는지 확인합니다. 노출카테고리코드는 숫자로만 입력 가능합니다. |