coupang
API 문서
상품 API카테고리 API브랜드 API배송 / 주문 API반품 API교환 API프로모션 / 쿠폰물류 정보고객 문의정산Rocket Growth
GET/v2/providers/seller_api/apis/api/v1/marketplace/meta/display-categories/{displayCategoryCode}v1

카테고리 조회

# 01

요약

API 적용 가능한 구매자 사용자 지역: 한국 카테고리 정보를 노출 카테고리 코드(displayCategoryCode)를 이용하여 조회한다. 1 Depth 카테고리 정보 조회는 노출카테고리코드 값을 0으로 설정 후 호출합니다.

# 02

상세

API 적용 가능한 구매자 사용자 지역: 한국
카테고리 정보를 노출 카테고리 코드(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
노출카테고리상태
Status Description
ACTIVE 서비스중
READY 서비스 준비중
DISABLED 사용 안함
  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 (요청변수확인)

노출카테고리코드는 숫자형으로 입력해주세요.

 올바른 노출카테고리코드를 입력했는지 확인합니다. 노출카테고리코드는 숫자로만 입력 가능합니다.