?

在開發電商系統、進行商品管理或市場分析時，獲取準確、完整的商品分類信息是基礎且關鍵的一環。1688開放平臺提供了相關的API接口，允許開發者通過編程方式獲取其龐大的商品分類體系。本文將介紹如何調用1688的“獲取商品分類樹”API。

一、 接口簡介

API名稱： alibaba.category.get

功能描述： 此接口用于獲取1688平臺的商品類目信息。它可以返回一級類目列表，或者根據傳入的父類目ID，查詢其下的子類目列表。

適用場景： 構建商品發布系統、完善商品信息庫、進行類目數據分析等。

二、 調用前準備

成為1688開放平臺開發者： 訪問1688開放平臺官網，注冊開發者賬號。

創建應用： 在開發者控制臺創建一個應用，獲取應用的關鍵憑證：

App Key：應用的唯一標識。

App Secret：用于接口調用的安全密鑰，需妥善保管。

獲取訪問令牌： 大多數API調用需要用戶授權。使用OAuth 2.0等授權流程獲取Access Token。請參考1688開放平臺的授權文檔。

三、 API調用詳解

請求地址 (Endpoint):

https://gw.open.1688.com/openapi/param2/1/com.alibaba.trade/alibaba.category.get/[App Key]

請將 [App Key] 替換為你實際的應用Key。

請求方式 (HTTP Method): GET 或 POST (根據官方文檔說明)

公共請求參數 (Common Parameters):

access_token: 用戶的訪問令牌，代表授權。

_aop_timestamp: 請求發送的時間戳（毫秒級）。

_aop_signature: 請求簽名，用于驗證請求的合法性。簽名算法是調用安全的關鍵，通常涉及 App Secret、請求參數和 _aop_timestamp 的特定組合計算（如HMAC-SHA1）。務必嚴格按照1688官方文檔的簽名規則生成。

業務請求參數 (API Specific Parameters):

parent_id (可選): 父類目ID。如果不傳此參數，則默認獲取所有一級類目。如果傳入有效的父類目ID，則返回該父類目下的直接子類目列表。

請求示例 (Python):

import requests
import time
import hashlib
import hmac
import base64
import urllib.parse

# 替換為你的實際信息
app_key = 'YOUR_APP_KEY'
app_secret = 'YOUR_APP_SECRET'
access_token = 'YOUR_ACCESS_TOKEN'

# 1. 準備公共參數
timestamp = str(int(time.time() * 1000))  # 毫秒時間戳
method = 'alibaba.category.get'  # API方法名
version = '1'  # API版本號

# 2. 構造待簽名字符串 (示例格式，具體規則請嚴格參照官方文檔)
# 通常格式: 方法名 + 時間戳 + App Key + App Secret + ... (可能包含其他參數)
# 這里是一個常見格式的示例:
string_to_sign = method + app_key + timestamp + app_secret
# 使用HMAC-SHA1生成簽名
sign = base64.b64encode(hmac.new(app_secret.encode('utf-8'), string_to_sign.encode('utf-8'), hashlib.sha1).digest())
sign = urllib.parse.quote(sign)  # URL編碼

# 3. 構建請求URL (假設是GET請求)
base_url = f'https://gw.open.1688.com/openapi/param2/{version}/com.alibaba.trade/{method}/{app_key}'
params = {
    'access_token': access_token,
    '_aop_timestamp': timestamp,
    '_aop_signature': sign,
    # 業務參數，例如獲取一級類目則不傳parent_id
    # 'parent_id': '0'  # 若要獲取某個父類目下的子類目，傳入其ID
}

# 4. 發送請求
response = requests.get(base_url, params=params)

# 5. 處理響應
if response.status_code == 200:
    data = response.json()
    # 解析data中的類目信息
    print(data)
else:
    print(f"請求失敗，狀態碼: {response.status_code}")

重要提示： 簽名生成算法 (_aop_signature) 是API調用的核心安全機制。上面的簽名示例 (string_to_sign = method + app_key + timestamp + app_secret) 僅用于演示思路，務必以1688開放平臺官方文檔中當前版本明確描述的簽名規則為準。錯誤的簽名會導致請求失敗。

響應數據結構 (示例): 成功的響應通常包含一個列表 (result.toReturn 或類似結構)，其中每個元素代表一個類目，可能包含以下字段：

id: 類目ID。

name: 類目名稱。

is_leaf: 是否是葉子類目（沒有子類目）。

level: 類目層級（如1表示一級類目）。

可能還有其他屬性如 parent_id, order 等。

四、 關鍵注意事項

簽名算法： 再次強調，簽名生成規則必須嚴格按照官方文檔。這是調用成功與否的關鍵。

權限范圍： 確保你的應用已申請并獲得調用該接口的權限。

頻率限制： 了解并遵守1688開放平臺的API調用頻率限制 (Rate Limit)，避免因頻繁調用被封禁。

錯誤處理： 仔細檢查響應中的 code 和 message 字段。常見的錯誤碼如：

400 (參數錯誤)

401 (認證失敗，如無效的 access_token 或簽名錯誤)

403 (權限不足或頻率超限)

500 (服務器內部錯誤)

類目體系更新： 1688的商品分類體系可能會動態調整。你的應用應設計相應的機制來處理可能的類目ID變更或新增。

獲取完整分類樹： 此接口通常一次只返回一層類目（一級類目或指定父類目的子類目）。要構建完整的分類樹，需要遞歸調用：先獲取所有一級類目，然后遍歷每個一級類目，將其 id 作為 parent_id 再次調用接口獲取其二級類目，以此類推，直到獲取到葉子類目 (is_leaf == true)。注意控制遞歸深度和頻率。

五、 總結

通過調用 alibaba.category.get 接口，開發者可以高效地獲取1688平臺的商品分類數據，為商品管理、數據分析等應用場景提供基礎支持。成功調用的關鍵在于正確配置應用憑證、遵循授權流程以及嚴格按照官方文檔實現請求簽名。務必關注頻率限制和錯誤處理，確保程序的健壯性。獲取完整分類樹結構需要遞歸調用策略。

補充說明：

本文中的代碼示例僅為演示邏輯，實際使用時請替換 YOUR_APP_KEY, YOUR_APP_SECRET, YOUR_ACCESS_TOKEN 為真實值，并嚴格遵循官方最新的簽名算法和參數規范。

請務必參考1688開放平臺官方提供的、對應API版本的最新文檔，以獲取最準確的信息：參數定義、請求示例、響應結構、錯誤代碼、調用限制等。

對于簽名等安全敏感操作，建議在開發階段使用1688提供的SDK（如果有）或成熟的HTTP請求庫，并仔細測試。

?審核編輯 黃宇