GET
/v2/providers/seller_api/apis/api/v2/marketplace/meta/category-related-metas/display-category-codes/{displayCategoryCode}2609170000品類元數據查詢
# 01
簡介
品類元數據查詢
# 02
詳細內容
支援地區:韓國、台灣
此 API 可透過「顯示品類代碼(displayCategoryCode)」查詢品類的資訊、屬性、所需文件及認證資訊等。
韓國地區說明
在建立商品時,商品建立訊息需與 Coupang 規定的各品類元資訊一致。
台灣地區說明
如何查詢購買選項與允許值(點擊)
路徑
GET/v2/providers/seller_api/apis/api/v2/marketplace/meta/category-related-metas/display-category-codes/{displayCategoryCode}
範例端點
https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v2/marketplace/meta/category-related-metas/display-category-codes/{displayCategoryCode}# 03
Path 參數
| Name | Type | Description |
|---|---|---|
| displayCategoryCode* | number | 顯示品類代碼
|
# 04
回應內容
回應訊息
| Name | Type | Description | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| code | string | 結果代碼: SUCCESS/ERROR | ||||||||||||
| message | string | 結果訊息
| ||||||||||||
| data | object | 品類元資訊(根據商品數量重複 N 次)
| ||||||||||||
| isAllowSingleItem data.isAllowSingleItem | boolean | 是否可註冊單件商品(是/否) ※ 即使為單一屬性商品,若輸入單一屬性值,則可直接註冊(2020 年底起適用) | ||||||||||||
| attributes data.attributes | object[] | 品類屬性列表(購買屬性 / 搜尋屬性) 根據屬性數量重複
| ||||||||||||
| attributeTypeName data.attributes[].attributeTypeName | string | 屬性類型名稱
| ||||||||||||
| dataType data.attributes[].dataType | string | 資料類型
| ||||||||||||
| basicUnit data.attributes[].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 data.attributes[].usableUnits | 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、套、膠囊、桶、容器、包、頭 | ||||||||||||
| required data.attributes[].required | string |
自由輸入屬性指南(20201012修改) | ||||||||||||
| groupNumber data.attributes[].groupNumber | string | 組屬性值:表示該屬性屬於某個屬性組,可能與其他屬性一起構成購買選項,並可能限制只能選擇其中一項。 NONE: 不是組属性 1 或 2:表示為組屬性。當屬性資訊中有多個屬性的 groupNumber 值相同時,只需輸入其中一個即可。 | ||||||||||||
| exposed data.attributes[].exposed | string | 購買屬性/搜尋屬性 區分
| ||||||||||||
| noticeCategories data.noticeCategories | object[] | 商品資訊品類列表 根據屬性數量重複 | ||||||||||||
| noticeCategoryName data.noticeCategories[].noticeCategoryName | string | 品類名稱
| ||||||||||||
| noticeCategoryDetailNames data.noticeCategories[].noticeCategoryDetailNames | object[] | 詳細名稱
| ||||||||||||
| noticeCategoryDetailName data.noticeCategories[].noticeCategoryDetailNames[].noticeCategoryDetailName | string | 詳細名稱
| ||||||||||||
| required data.noticeCategories[].noticeCategoryDetailNames[].required | string | 是否必填
| ||||||||||||
| requiredDocumentNames data.requiredDocumentNames | object[] | 所需文件列表 根據屬性數量重複 | ||||||||||||
| templateName data.requiredDocumentNames[].templateName | string | 所需文件名
| ||||||||||||
| required data.requiredDocumentNames[].required | string | 是否必須提交所需文件
| ||||||||||||
| certifications data.certifications | object[] | 商品認證資訊 根據屬性數量重複 | ||||||||||||
| certificationType data.certifications[].certificationType | string | 認證類型
| ||||||||||||
| name data.certifications[].name | string | 認證名稱
| ||||||||||||
| dataType data.certifications[].dataType | string | 資料類型 CODE (輸入認證機構發行的代碼) NONE (無須輸入代碼) | ||||||||||||
| required data.certifications[].required | string | 是否必填 MANDATORY (必填) RECOMMEND (建議填寫) OPTIONAL (選填) | ||||||||||||
| allowedOfferConditions data.allowedOfferConditions | string[] | 可註冊的商品狀態 可根據顯示的值,確認是否可註冊翻新或二手商品。
|
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"
]
}
}# 05
錯誤碼
| HTTP | 代碼 | 訊息 |
|---|---|---|
| 400 | HTTP_400 | Bad Request |
錯誤說明
| HTTP | 類型 | 錯誤訊息 | 解決方案 |
|---|---|---|---|
| 400 | 400 (Check Request Parameter) | 找不到對應的管理類別代碼,請聯繫您的 MD 並輸入正確的展示類別 | 請確認您輸入的展示類別代碼是否正確 |
| 400 | 400 (Check Request Parameter) | 請確認展示類別代碼是數字格式。 | 請確認展示類別代碼是否正確。展示類別代碼只能是數字格式 |