API支持的买家用户地区：韩国

使用displayCategoryCode可以搜索属于相关类别的通知信息、选项、所需文件和认证信息列表。创建产品时，产品创建文本必须由与 Coupang 指定的每个类别的元信息相匹配的项目组成。在类目元信息查询的情况下，使用与市场相同的端点，并提供一个附加参数来确定所搜索的类目是否需要有效期信息。对于 Rocket Growth 产品，注册产品时必须根据适用参数提供有效期信息。

Path

GET

/v2/providers/seller_api/apis/api/v1/marketplace/meta/category-related-metas/display-category-codes/{displayCategoryCode}

Example Endpoint

GET https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/meta/category-related-metas/display-category-codes/78877

Request Parameters

Path Segment Parameter

Name	Required	Type	Description
displayCategoryCode	O	Number	노출카테고리코드

Request Example

not require body

Response Message

Name

Type

Description

code

Number

结果代码:

SUCCESS/ERROR

message

String

结果信息

data

Array

品类元信息

按查询到的卖家商品数量，重复N次

isAllowSingleItem

Boolean

是否可以注册单件商品

是/否

※ 与isAllowSingleItem的值无关，如果输入一个单一属性商品，在商品创建时则无需输入属性值(attributes)即可注册。(2020年底开始适用)

attributes

Array

品类属性列表 (购买属性/搜索属性)

根据属性数量重复

商品销售通过审批前，可添加、更改或删除attributes
商品销售通过审批后，可添加attributes，但不可删除或更改

attributeTypeName

String

属性类型名

required

String

Response Value	Mean
MANDATORY	必选
OPTIONAL	可选

※ 可自由组成购买属性(open attribute)。详细信息请参阅下方指南。

自由输入购买属性指南(20201012修改)

dataType

String

数据类型

Response Value	Mean
STRING	字符串
NUMBER	数字
DATE	日期

basicUnit

String

基本单位

例)

长度(cm): cm, mm, m, km

长度 (英尺): in, ft, yd

重量(g): mg, g, kg, t, oz, lb

体积 (ml): cc, ml, L

数据容量(GB): KB, MB, GB, TB

数量(个): 个、()个入、枚、()枚入、片、()个、张、瓶、()人用、()人份、 box、Ea、包、罐、本、set、套、胶囊、桶、容器、纸包、头

usableUnits

 Array

可使用的单位值列表

例)

长度(cm): cm, mm, m, km

长度 (英尺): in, ft, yd

重量(g): mg, g, kg, t, oz, lb

体积 (ml): cc, ml, L

数据容量(GB): KB, MB, GB, TB

数量(个): 个、()个入、枚、()枚入、片、()个、张、瓶、()人用、()人份、box、Ea、包、罐、本、set、套、胶囊、桶、容器、纸包、头

groupNumber

String

组属性值(属性中择1，是否为所属状态的属性)

NONE: 不是组属性

1 or 2: 是组属性。此时，若属性信息中有与groupNumber 值相同的属性，则只输入其中一个即可

exposed

String

购买属性/搜索属性区分值

Response Value	Mean
EXPOSED	购买属性
NONE	搜索属性

noticeCategories

Array

商品信息列表

根据属性数量重复

noticeCategoryName

String

商品信息品类名

noticeCategoryDetailNames

String

商品信息品类详细列表

noticeCategoryDetailName

String

商品信息品类详细名称

required

String

是否为必须项

Response Value	Mean
MANDATORY	必须
OPTIONAL	可选

requiredDocumentNames

Array

所需文件列表

根据属性数量重复

templateName

String

所需文件名

required

String

是否必须提交所需文件

Response Value	Mean
MANDATORY	必填
OPTIONAL	选填

certifications

Array

商品认证信息

根据属性数量重复

certificationType

String

name

String

认证信息名称

dataType

String

认证信息名称

CODE (输入认证机构发行的代码)

NONE (无需输入代码)

required

String

是否为必须项

MANDATORY (必须)

RECOMMEND (建议填写)

OPTIONAL (可选)

allowedOfferConditions

Array

允许的商品状态

可根据显示的值，确认是否可以注册翻新或二手商品

Response Value	Mean
NEW	新商品
REFURBISHED	翻新
USED_BEST	二手 (上佳)
USED_GOOD	二手 (良好)
USED_NORMAL	二手 (一般)

isExpirationDateRequiredForRocketGrowth

Boolean

对于韩国本地火箭仓商品的SKU信息而言，消费期限是否为必填项。

Response Example

{

  "code": "SUCCESS",

  "message": "",

  "data": {

    "isAllowSingleItem": true,

    "attributes": [

      {

        "attributeTypeName": "수량",

        "dataType": "NUMBER",

        "basicUnit": "개",

        "usableUnits": [

          "개",

          "개입",

          "매",

          "매입",

          "팩",

          "입",

          "장",

          "병",

          "인용",

          "인분",

          "box",

          "Ea",

          "포",

          "캔",

          "박스",

          "스틱",

          "권",

          "set",

          "세트",

          "조",

          "캡슐",

          "통",

          "정",

          "봉",

          "마리",

          "롤",

          "p",

          "구",

          "피스",

          "회",

          "회분",

          "단계",

          "번",

          "프렛",

          "음판",

          "건반",

          "쪽",

          "단",

          "칸",

          "종",

          "분류",

          "현",

          "선",

          "공",

          "자리",

          "폭",

          "rpm",

          "색",

          "대"

        ],

        "required": "OPTIONAL",

        "groupNumber": "NONE",

        "exposed": "EXPOSED"

      },

      {

        "attributeTypeName": "자동차거치용품 거치대고정",

        "dataType": "STRING",

        "basicUnit": "없음",

        "usableUnits": [],

        "required": "OPTIONAL",

        "groupNumber": "NONE",

        "exposed": "NONE"

      },

      {

        "attributeTypeName": "헤드 회전 가능여부",

        "dataType": "STRING",

        "basicUnit": "없음",

        "usableUnits": [],

        "required": "OPTIONAL",

        "groupNumber": "NONE",

        "exposed": "NONE"

      },

      {

        "attributeTypeName": "각도조절 가능여부",

        "dataType": "STRING",

        "basicUnit": "없음",

        "usableUnits": [],

        "required": "OPTIONAL",

        "groupNumber": "NONE",

        "exposed": "NONE"

      }

    ],

    "noticeCategories": [

      {

        "noticeCategoryName": "자동차용품(자동차부품/기타 자동차용품)",

        "noticeCategoryDetailNames": [

          {

            "noticeCategoryDetailName": "품명 및 모델명",

            "required": "MANDATORY"

          },

          {

            "noticeCategoryDetailName": "출시년월",

            "required": "MANDATORY"

          },

          {

            "noticeCategoryDetailName": "KC 인증 필 유무",

            "required": "MANDATORY"

          },

          {

            "noticeCategoryDetailName": "제조자(수입자)",

            "required": "MANDATORY"

          },

          {

            "noticeCategoryDetailName": "제조국",

            "required": "MANDATORY"

          },

          {

            "noticeCategoryDetailName": "크기",

            "required": "MANDATORY"

          },

          {

            "noticeCategoryDetailName": "적용차종",

            "required": "MANDATORY"

          },

          {

            "noticeCategoryDetailName": "품질보증기준",

            "required": "MANDATORY"

          },

          {

            "noticeCategoryDetailName": "A/S 책임자와 전화번호",

            "required": "MANDATORY"

          }

        ]

      },

      {

        "noticeCategoryName": "기타 재화",

        "noticeCategoryDetailNames": [

          {

            "noticeCategoryDetailName": "품명 및 모델명",

            "required": "MANDATORY"

          },

          {

            "noticeCategoryDetailName": "인증사항",

            "required": "MANDATORY"

          },

          {

            "noticeCategoryDetailName": "제조국(원산지)",

            "required": "MANDATORY"

          },

          {

            "noticeCategoryDetailName": "제조자(수입자)",

            "required": "MANDATORY"

          },

          {

            "noticeCategoryDetailName": "소비자상담 관련 전화번호",

            "required": "MANDATORY"

          }

        ]

      }

    ],

    "requiredDocumentNames": [

      {

        "templateName": "기타인증서류",

        "required": "OPTIONAL"

      },

      {

        "templateName": "수입신고필증(병행수입 선택시)",

        "required": "MANDATORY_PARALLEL_IMPORTED"

      },

      {

        "templateName": "인보이스영수증(해외구매대행 선택시)",

        "required": "MANDATORY_OVERSEAS_PURCHASED"

      }

    ],

    "certifications": [

      {

        "certificationType": "NOT_REQUIRED",

        "name": "인증대상아님",

        "dataType": "NONE",

        "required": "OPTIONAL"

      },

      {

        "certificationType": "PRESENTED_IN_DETAIL_PAGE",

        "name": "상세설명에 표시",

        "dataType": "NONE",

        "required": "OPTIONAL"

      },

      {

        "certificationType": "KC_KID_CERTIFICATION",

        "name": "KC인증 어린이제품 안전인증",

        "dataType": "CODE",

        "required": "RECOMMEND"

      },

      {

        "certificationType": "KC_KID_CONFIRM",

        "name": "KC인증 어린이제품 안전확인",

        "dataType": "CODE",

        "required": "OPTIONAL"

      },

      {

        "certificationType": "KC_KID_PROVIDER",

        "name": "KC인증 어린이제품 공급자적합성확인",

        "dataType": "NONE",

        "required": "OPTIONAL"

      },

      {

        "certificationType": "KC_ELECTRONICS_CERTIFICATION",

        "name": "KC인증 전기용품 안전인증",

        "dataType": "CODE",

        "required": "OPTIONAL"

      },

      {

        "certificationType": "KC_ELECTRONICS_CONFIRM",

        "name": "KC인증 전기용품 안전확인",

        "dataType": "CODE",

        "required": "OPTIONAL"

      },

      {

        "certificationType": "KC_ELECTRONICS_PROVIDER",

        "name": "KC인증 전기용품 공급자적합성확인",

        "dataType": "NONE",

        "required": "OPTIONAL"

      },

      {

        "certificationType": "KC_HOUSEHOLD_CERTIFICATION",

        "name": "KC인증 생활용품 안전인증",

        "dataType": "CODE",

        "required": "RECOMMEND"

      },

      {

        "certificationType": "KC_HOUSEHOLD_CONFIRM",

        "name": "KC인증 생활용품 자율안전확인",

        "dataType": "CODE",

        "required": "RECOMMEND"

      },

      {

        "certificationType": "KC_HOUSEHOLD_QUALITY",

        "name": "KC인증 생활용품 안전품질표시",

        "dataType": "NONE",

        "required": "RECOMMEND"

      },

      {

        "certificationType": "KC_HOUSEHOLD_PACKAGING",

        "name": "KC인증 생활용품 어린이보호포장",

        "dataType": "NONE",

        "required": "RECOMMEND"

      },

      {

        "certificationType": "COMMUNICATION_EQUIPMENT",

        "name": "방송통신기자재 적합성 평가 대상",

        "dataType": "CODE",

        "required": "RECOMMEND"

      }

    ],

    "allowedOfferConditions": [

      "NEW",

      "REFURBISHED",

      "USED_BEST",

      "USED_GOOD",

      "USED_NORMAL"

    ],

    "isExpirationDateRequired": true

  }

}

Error Spec

HTTP Status Code (Error Type)	Error Message	Solution
400 (确认请求参数)	未找到该显示品类代码的管理品类。请向负责的MD确认并输入有效显示品类。	请确保输入的显示品类代码正确无误。
400 (确认请求参数)	请以数字形式输入显示品类代码。	请确认您输入的显示(展示)品类代码是否正确。显示(展示)品类代码仅支持输入数字。

品类元数据查询

简介

详细内容

Path

Example Endpoint

Request Parameters

Path Segment Parameter

Request Example

Response Message

Response Example

Error Spec