/v1/taxonomyTree
取得分類樹與類別細節，包括商品規格表。
- 請使用 GET 進行呼叫
|
Attribute |
Value |
|---|---|
|
API Name |
取分類樹資訊 (/taxonomyTree) |
|
API Desc |
取得分類樹與類別細節 |
|
Version |
1 |
|
Request URI |
https://tw.ews.mall.yahooapis.com/stauth/v1/taxonomyTree OR https://tw.ews.mall.yahooapis.com/oauth/v1/taxonomyTree |
|
Change Log |
* |
Response fields
|
Field |
Description |
|---|---|
|
id |
分類代號 |
|
name |
分類名稱 |
|
IsLink |
是否為關聯性分類 (string) true/false |
|
IsLeaf |
是否為最底層分類 (string) true/false |
|
level |
分類所在的階層 (int) |
|
parentIds |
上層分類代號 (int) 以 L3 類別為例，parentIds 將先列 出 L2 代號，再列出 L1 代號 |
|
depth |
分類所在的階層 (int) |
|
path |
分類路徑 (int) |
|
subTaxonomies |
下一層分類細節 (int) |
|
clusters |
leaf分類須額外填寫的商品規格表 |
Sample response
JSON sample
{
"id": "0",
"name": "PROCESSHOTDEFAULT_ROOTLABEL",
"isLink": false,
"isLeaf": false,
"level": 0,
"parentIds": [
"0"
],
"depth": 0,
"path": "PROCESSHOTDEFAULT_ROOTLABEL",
"subTaxonomies": [
{
"id": "4385943",
"name": "手機/相機/耳機/穿戴",
"isLink": false,
"isLeaf": false,
"level": 1,
"parentIds": [
"0"
],
"depth": 1,
"path": "手機/相機/耳機/穿戴",
"subTaxonomies": [
{
"id": "28507312",
"name": "手機",
"isLink": false,
"isLeaf": false,
"level": 2,
"parentIds": [
"4385943",
"0"
],
"depth": 2,
"path": "手機/相機/耳機/穿戴 > 手機",
"subTaxonomies": [
{
"id": "4385945",
"name": "智慧型手機",
"isLink": false,
"isLeaf": true,
"level": 3,
"parentIds": [
"28507312",
"4385943",
"0"
],
"depth": 3,
"path": "手機/相機/耳機/穿戴 > 手機 > 智慧型手機",
"clusters": [
{
"id": "000003012454",
"name": "智慧型手機",
"attributes": {
"4G LTE頻段": {
"name": "4G LTE頻段",
"type": "string",
"order": 0,
"required": 1,
"searchable": 0,
"value": [
"1",
"50"
]
},
"NCC認證碼": {
"name": "NCC認證碼",
"type": "string",
"order": 1,
"required": 1,
"searchable": 0,
"value": [
"1",
"50"
]
}
}
}
]
}
]
}
]
}
]
}
XML sample
<?xml version="1.0" encoding="UTF-8"?>
<id>0</id>
<name>PROCESSHOTDEFAULT_ROOTLABEL</name>
<isLink>false</isLink>
<isLeaf>false</isLeaf>
<level>0</level>
<parentIds>0</parentIds>
<depth>0</depth>
<path>PROCESSHOTDEFAULT_ROOTLABEL</path>
<subTaxonomies>
<id>4385943</id>
<name>手機/相機/耳機/穿戴</name>
<isLink>false</isLink>
<isLeaf>false</isLeaf>
<level>1</level>
<parentIds>0</parentIds>
<depth>1</depth>
<path>手機/相機/耳機/穿戴</path>
<subTaxonomies>
<id>28507312</id>
<name>手機</name>
<isLink>false</isLink>
<isLeaf>false</isLeaf>
<level>2</level>
<parentIds>4385943</parentIds>
<parentIds>0</parentIds>
<depth>2</depth>
<path>手機/相機/耳機/穿戴 > 手機</path>
<subTaxonomies>
<id>4385945</id>
<name>智慧型手機</name>
<isLink>false</isLink>
<isLeaf>true</isLeaf>
<level>3</level>
<parentIds>28507312</parentIds>
<parentIds>4385943</parentIds>
<parentIds>0</parentIds>
<depth>3</depth>
<path>手機/相機/耳機/穿戴 > 手機 > 智慧型手機</path>
<clusters>
<id>000003012454</id>
<name>智慧型手機</name>
<attributes>
<4G LTE頻段>
<name>4G LTE頻段</name>
<type>string</type>
<order>0</order>
<required>1</required>
<searchable>0</searchable>
<value>1</value>
<value>50</value>
</4G LTE頻段>
<NCC認證碼>
<name>NCC認證碼</name>
<type>string</type>
<order>1</order>
<required>1</required>
<searchable>0</searchable>
<value>1</value>
<value>50</value>
</NCC認證碼>
</attributes>
</clusters>
</subTaxonomies>
</subTaxonomies>
Errors
|
ErrorCode |
ErrorMessage |
|---|---|
|
1701 |
CategoryId is empty |
|
1702 |
Unknow CategoryId |
|
99 |
Internal server error |
/v1/taxonomies/分類ID
取得特定分類的細節（請在 URI 最後面填入要查詢的分類代號）
- 請使用 GET 進行呼叫
|
Attribute |
Value |
|---|---|
|
API Name |
取特定分類細節 (/v1/taxonomies/分類ID) |
|
API Desc |
取得特定分類的細節 |
|
Version |
1 |
|
Request URI |
http://tw.ews.mall.yahooapis.com/stauth/v1/taxonomies/4385945 OR https://tw.ews.mall.yahooapis.com/oauth/v1/taxonomies/4385945 |
|
Change Log |
* |
Request parameters
|
Parameter |
Value |
Description |
|---|---|---|
|
detail |
string (Require) |
true/false true: 回應結果將包含商品規格表 false: 回應結果不包含商品規格表 |
Sample response
{
"id": "4385945",
"name": "智慧型手機",
"isLink": false,
"isLeaf": true,
"level": 3,
"parentIds": [
"28507312",
"4385943",
"0"
],
"depth": 3,
"path": "手機/相機/耳機/穿戴 > 手機 > 智慧型手機",
"clusters": [
{
"id": "000003012454",
"name": "智慧型手機",
"attributes": {
"品牌": {
"name": "品牌",
"type": "choiceof",
"order": 0,
"required": 1,
"searchable": 1,
"value": [
"Acer宏碁",
"Apple",
"ASUS華碩",
"BenQ明基",
"BlackBerry黑莓",
"CAT",
"GPLUS",
"Google",
"HTC",
"HUAWEI華為",
"inFocus富可視",
"iNo",
"K-TOUCH",
"LG樂金",
"Meitu 美圖",
"Microsoft微軟",
"moto",
"Nokia諾基亞",
"OPPO",
"Panasonic國際牌",
"Razer雷蛇",
"SAMSUNG三星",
"SHARP夏普",
"SONY",
"SUGAR糖果",
"vivo",
"Xiaomi小米",
"其他品牌"
]
},
"型號": {
"name": "型號",
"type": "choiceof",
"order": 1,
"required": 1,
"searchable": 1,
"value": [
"2.1",
"3",
"3.1",
"3.1 Plus",
"4",
"5",
"5 Plus",
"5.1 Plus",
"6",
"6.1",
"6.1 Plus",
"8",
"8.1",
"9",
"10",
"398",
"550",
"3310",
"5218",
"8110",
"10 evo",
"107 plus",
"3e",
"3G pro",
"3Ga",
"7 plus",
"A1",
"A1 plus",
"A2 plus",
"A3",
"A30",
"A35",
"A57",
"A6 plus",
"A7 2016",
"A7 2017",
"A7 2018",
"A73",
"A73s",
"A75",
"A75s",
"A77",
"A8",
"A8 2016",
"A8 plus",
"A8 Star",
"A8s",
"A9",
"A9 2018",
"AQUOS Zero",
"AX5",
"AX7",
"AX7 Pro",
"B50",
"Blade V7 Lite",
"C",
"C7",
"C11",
"C11s",
"C12",
"C3",
"C33",
"CP100",
"CP200",
"CP39",
"D10",
"Desire 650",
"Desire 10 lifestyle",
"Desire 10 lifestyle",
"Desire 10 pro",
"Desire 12",
"Desire 12s",
"Desire 728",
"E5 Plus",
"ELUGA C",
"ELUGA Y",
"ELUGA Y Pro",
"F1",
"F1s",
"F2",
"F35",
"F51",
"F55J",
"F68 plus",
"FW6950",
"Find X",
"G128",
"G5",
"G5 Speed",
"G588",
"g5s",
"g5s plus",
"G6",
"g6 plus",
"G628+",
"G7",
"GB301",
"GB301",
"GH7200",
"GH7800",
"GH7900",
"GT30",
"H30",
"Holo 360",
"iPhone 5",
"iPhone 5S",
"iPhone 6",
"iPhone 6s",
"iPhone 6s Plus",
"iPhone 7",
"iPhone 7 PLUS",
"iPhone 8",
"iPhone 8 Plus",
"iPhone SE",
"iPhone X",
"iPhone XR",
"iPhone Xs",
"iPhone Xs Max",
"J2 prime",
"J2 pro",
"J3 pro",
"J4",
"J4 plus",
"J5",
"J6",
"J6 plus",
"J7 plus",
"J7 prime",
"J7 pro",
"J8",
"K10",
"K10 2017",
"K4 2017",
"K8",
"K800",
"K89A",
"K9",
"K900",
"L2",
"L5",
"L50",
"L63",
"L66",
"M1",
"M105",
"M106",
"M3310",
"M378",
"M398",
"M518",
"M535",
"M5s",
"M6",
"M7s",
"M800",
"M8s",
"M900",
"Mate 10",
"Mate 10 pro",
"Mate 20",
"Mate 20 Pro",
"Mate 20 X",
"Max 2",
"Max Pro",
"Max Pro M2",
"MIX 2",
"MIX 3",
"N6",
"NEX",
"NEXUS 6",
"Note",
"Note 2",
"Note 3",
"Note 4",
"Note 4X",
"Note 5",
"Note 6 Pro",
"Note 8",
"Note 9",
"Note edge",
"Nova 2i",
"Nova 3",
"Nova 3e",
"Nova 3i",
"One",
"One A9s",
"One X10",
"One X9",
"P1",
"P9 Lite",
"P10 Plus",
"P20",
"P20 pro",
"Q6",
"Q7+",
"Q stylus+(Q stylus plus)",
"R17",
"R15",
"R15 pro",
"R17",
"R17 Pro",
"R9",
"R9s",
"R9s plus",
"R11",
"R11s",
"R11s plus",
"Razer Phone 2",
"RZ35-0215",
"Robin",
"ROG Phone ZS600KL",
"S11",
"S2",
"S20",
"S20s",
"S3",
"S31",
"S41",
"S6",
"S6 edge",
"S6 edge plus",
"S60",
"S61",
"S7",
"S7 edge",
"S8",
"S8 plus",
"S80",
"S9",
"S9 plus",
"S10",
"S10+",
"Smart 109",
"Smart 505",
"Smart 508",
"Smart 509",
"Smart 601",
"Stylus 3",
"T2 ultra",
"T26",
"T55",
"T8",
"T8s",
"T9",
"TS550",
"TS550 plus",
"U Play",
"U Ultra",
"U11",
"U11 eyes",
"U11 plus",
"U12 plus",
"U12 life",
"V9",
"V9 Youth",
"V10",
"V11",
"V11i",
"V30 plus",
"V30s ThinkQ",
"V40 ThinQ",
"V7 plus",
"VS100",
"W168",
"W188",
"W95 plus",
"WE",
"Wine Smart H410",
"X21",
"X4",
"XA ultra",
"XA1",
"XA1 plus",
"XA1 ultra",
"XA2",
"XA2 Plus",
"XA2 ultra",
"Xperia X Performance",
"XZ",
"XZ premium",
"XZ1",
"XZ1 compact",
"XZ2",
"XZ2 Premium",
"XZ3",
"XZs",
"Y132",
"Y336",
"Y336 plus",
"Y5 plus",
"Y6",
"Y6 plus",
"Y7 Prime",
"Y7s",
"Y8 MAX",
"Y81",
"Y9 2019",
"Y95",
"Z",
"Z ultra",
"Z2",
"Z2 Play",
"Z2a",
"Z3",
"Z5",
"Z5 premium",
"ZenFone Go ZB450KL",
"ZenFone Max (M1) ZB555KL",
"Zenfone Max M2 ZB633KL",
"ZenFone Live (L1) ZA550KL",
"ZenFone Max Pro ZB602KL",
"Zenfone Max Pro (M2) ZB631KL",
"ZenFone2 Deluxe ZE551ML",
"ZenFone2 ZE500CL",
"ZenFone2 ZE550ML",
"ZenFone 3 Deluxe ZS550KL",
"ZenFone 3 Deluxe ZS570KL",
"ZenFone3 ZE520KL",
"ZenFone3 ZE552KL",
"Zenfone 3 Max ZC520TL",
"ZenFone 3 Max ZC553KL",
"ZenFone3 ZOOM ZE553KL",
"ZenFone4 Max ZC554KL",
"ZenFone4 Pro ZS551KL",
"Zenfone selfie ZD551KL",
"ZenFone4 Selfie Pro ZD552KL",
"ZenFone4 ZE554KL",
"ZenFone5 ZE620KL",
"ZenFone5Q ZC600KL",
"ZenFone5Z ZS620K",
"ZenFoneAR ZS571KL",
"ZenFone Ares ZS572KL",
"ZenFoneLive ZB501KL",
"ZenFoneMax Plus (M1) ZB570TL"
]
},
"顏色": {
"name": "顏色",
"type": "checkboxof",
"order": 2,
"required": 1,
"searchable": 1,
"value": [
"白色系",
"多色系",
"灰色系",
"咖啡色系",
"金色系",
"紅色系",
"粉紅色系",
"紫色系",
"黃色系",
"黑色系",
"綠色系",
"銀色系",
"橘色系",
"藍色系"
]
},
"螢幕尺寸": {
"name": "螢幕尺寸",
"type": "choiceof",
"order": 3,
"required": 1,
"searchable": 1,
"value": [
"4吋以下",
"4吋",
"4.5吋",
"4.6吋",
"4.7吋",
"5吋",
"5.1吋",
"5.2吋",
"5.3吋",
"5.5吋",
"5.7吋",
"5.8吋",
"5.9吋",
"6吋",
"6.1吋",
"6.2吋",
"6.3吋",
"6.4吋",
"6.5吋",
"6.8吋",
"6.8吋以上"
]
},
"處理器類型": {
"name": "處理器類型",
"type": "choiceof",
"order": 4,
"required": 1,
"searchable": 1,
"value": [
"十核心",
"八核心",
"六核心",
"四核心",
"雙核心",
"單核心",
"其他處理器分類"
]
},
"處理器型號": {
"name": "處理器型號",
"type": "string",
"order": 5,
"required": 1,
"searchable": 0,
"value": [
"1",
"50"
]
},
"處理器時脈": {
"name": "處理器時脈",
"type": "string",
"order": 6,
"required": 1,
"searchable": 0,
"value": [
"1",
"50"
]
},
"主相機畫素": {
"name": "主相機畫素",
"type": "checkboxof",
"order": 7,
"required": 1,
"searchable": 1,
"value": [
"無相機畫素",
"500萬以下",
"500萬",
"800萬",
"1200萬",
"1230萬",
"1300萬",
"1600萬",
"1900萬",
"2000萬",
"2100萬",
"2300萬",
"2300萬以上"
]
},
"前鏡頭畫素": {
"name": "前鏡頭畫素",
"type": "choiceof",
"order": 8,
"required": 1,
"searchable": 0,
"value": [
"無相機畫素",
"500萬以下",
"500萬",
"700萬",
"800萬",
"1200萬",
"1230萬",
"1300萬",
"1600萬",
"2000萬",
"2100萬",
"2260萬",
"2300萬",
"2300萬以上"
]
},
"螢幕解析度": {
"name": "螢幕解析度",
"type": "string",
"order": 9,
"required": 1,
"searchable": 0,
"value": [
"1",
"50"
]
},
"螢幕技術": {
"name": "螢幕技術",
"type": "choiceof",
"order": 10,
"required": 0,
"searchable": 1,
"value": [
"IPS",
"AMOLED",
"TFT"
]
},
"RAM記憶體": {
"name": "RAM記憶體",
"type": "choiceof",
"order": 11,
"required": 0,
"searchable": 0,
"value": [
"1GB",
"1.5GB",
"2GB",
"3GB",
"4GB",
"6GB",
"8GB"
]
},
"ROM/內建儲存空間": {
"name": "ROM/內建儲存空間",
"type": "choiceof",
"order": 12,
"required": 1,
"searchable": 1,
"value": [
"4GB",
"8GB",
"16GB",
"32GB",
"64GB",
"128GB",
"256GB",
"512GB"
]
},
"記憶卡插槽": {
"name": "記憶卡插槽",
"type": "choiceof",
"order": 13,
"required": 1,
"searchable": 0,
"value": [
"無",
"microSD",
"Nano Memory Card"
]
},
"作業系統": {
"name": "作業系統",
"type": "string",
"order": 14,
"required": 1,
"searchable": 0,
"value": [
"1",
"50"
]
},
"機身長度(mm)": {
"name": "機身長度(mm)",
"type": "string",
"order": 15,
"required": 1,
"searchable": 0,
"value": [
"1",
"50"
]
},
"機身寬度(mm)": {
"name": "機身寬度(mm)",
"type": "string",
"order": 16,
"required": 1,
"searchable": 0,
"value": [
"1",
"50"
]
},
"機身厚度(mm)": {
"name": "機身厚度(mm)",
"type": "string",
"order": 17,
"required": 1,
"searchable": 0,
"value": [
"1",
"50"
]
},
"機身重量(g)": {
"name": "機身重量(g)",
"type": "string",
"order": 18,
"required": 1,
"searchable": 0,
"value": [
"1",
"50"
]
},
"電池容量(mAh)": {
"name": "電池容量(mAh)",
"type": "string",
"order": 19,
"required": 1,
"searchable": 0,
"value": [
"1",
"50"
]
},
"相機功能": {
"name": "相機功能",
"type": "string",
"order": 20,
"required": 0,
"searchable": 0,
"value": [
"1",
"50"
]
},
"視訊鏡頭": {
"name": "視訊鏡頭",
"type": "choiceof",
"order": 21,
"required": 1,
"searchable": 0,
"value": [
"有視訊鏡頭",
"無"
]
},
"錄影格式": {
"name": "錄影格式",
"type": "checkboxof",
"order": 22,
"required": 0,
"searchable": 0,
"value": [
"3GP",
"ASF",
"AVI",
"H.263",
"mov",
"MPEG4",
"RealMedia",
"WMV",
"其他"
]
},
"上網方式": {
"name": "上網方式",
"type": "checkboxof",
"order": 23,
"required": 0,
"searchable": 0,
"value": [
"WiFi",
"4G LTE",
"3G",
"GPRS"
]
},
"藍牙": {
"name": "藍牙",
"type": "choiceof",
"order": 24,
"required": 1,
"searchable": 0,
"value": [
"有藍牙",
"無"
]
},
"待機時間(最大)": {
"name": "待機時間(最大)",
"type": "string",
"order": 25,
"required": 1,
"searchable": 0,
"value": [
"1",
"50"
]
},
"通話時間(最大)": {
"name": "通話時間(最大)",
"type": "string",
"order": 26,
"required": 1,
"searchable": 0,
"value": [
"1",
"50"
]
},
"手機類型": {
"name": "手機類型",
"type": "checkboxof",
"order": 27,
"required": 1,
"searchable": 1,
"value": [
"防潑水",
"雙卡雙待機",
"支援亞太CDMA",
"支援4G LTE",
"僅支援3G"
]
},
"防水等級": {
"name": "防水等級",
"type": "string",
"order": 28,
"required": 0,
"searchable": 0,
"value": [
"1",
"50"
]
},
"音樂播放器": {
"name": "音樂播放器",
"type": "string",
"order": 29,
"required": 0,
"searchable": 0,
"value": [
"1",
"50"
]
},
"影片播放格式": {
"name": "影片播放格式",
"type": "string",
"order": 30,
"required": 0,
"searchable": 0,
"value": [
"1",
"50"
]
},
"傳輸介面": {
"name": "傳輸介面",
"type": "checkboxof",
"order": 31,
"required": 0,
"searchable": 1,
"value": [
"A2DP",
"HDMI",
"NFC",
"POP-Port",
"TV-OUT",
"USB OTG",
"USB",
"紅外線",
"藍牙"
]
},
"圖片支援格式": {
"name": "圖片支援格式",
"type": "string",
"order": 32,
"required": 0,
"searchable": 0,
"value": [
"1",
"50"
]
},
"頻率系統": {
"name": "頻率系統",
"type": "string",
"order": 33,
"required": 1,
"searchable": 0,
"value": [
"1",
"50"
]
},
"4G LTE頻段": {
"name": "4G LTE頻段",
"type": "string",
"order": 34,
"required": 1,
"searchable": 0,
"value": [
"1",
"50"
]
},
"可支援4G電信系統": {
"name": "可支援4G電信系統",
"type": "checkboxof",
"order": 35,
"required": 0,
"searchable": 0,
"value": [
"中華",
"台灣大哥大",
"遠傳",
"亞太",
"台灣之星",
"全頻"
]
},
"雙卡頻段": {
"name": "雙卡頻段",
"type": "checkboxof",
"order": 36,
"required": 0,
"searchable": 0,
"value": [
"2G+2G",
"2G+3G",
"4G+2G",
"4G+3G",
"4G+4G"
]
},
"SIM卡尺寸": {
"name": "SIM卡尺寸",
"type": "checkboxof",
"order": 37,
"required": 1,
"searchable": 1,
"value": [
"mini sim",
"micro sim",
"nano sim"
]
},
"雙SIM卡類型": {
"name": "雙SIM卡類型",
"type": "string",
"order": 38,
"required": 0,
"searchable": 0,
"value": [
"1",
"50"
]
},
"感光元件": {
"name": "感光元件",
"type": "choiceof",
"order": 39,
"required": 0,
"searchable": 0,
"value": [
"CCD",
"CMOS"
]
},
"NCC認證碼": {
"name": "NCC認證碼",
"type": "string",
"order": 40,
"required": 1,
"searchable": 0,
"value": [
"1",
"50"
]
},
"標準配備": {
"name": "標準配備",
"type": "string",
"order": 41,
"required": 1,
"searchable": 0,
"value": [
"1",
"50"
]
}
}
}
]
}
Errors
|
ErrorCode |
ErrorMessage |
|---|---|
|
1701 |
CategoryId is empty |
|
1702 |
Unknow CategoryId |
|
99 |
Internal server error |