?

一、接口概述

1688開放平臺提供alibaba.category.get接口，支持開發(fā)者獲取全量商品類目樹。該接口采用RESTful架構，返回JSON格式數(shù)據(jù)，包含以下核心字段：

categoryId：類目唯一標識符

name：類目中文名稱

level：類目層級（1-5級）

parentId：父類目ID

isLeaf：是否葉子類目

二、請求準備

需提前完成：

注冊1688開放平臺賬號

創(chuàng)建應用獲取app_key和app_secret

申請"商品類目接口"權限

安裝HTTP請求庫（示例使用Python）

import requests
import hashlib
import time

# 認證參數(shù)
app_key = "YOUR_APP_KEY" 
app_secret = "YOUR_APP_SECRET"

三、請求構造

1. 基礎參數(shù)

params = {
    "method": "alibaba.category.get",
    "app_key": app_key,
    "timestamp": str(int(time.time() * 1000)),  # 精確到毫秒
    "format": "json",
    "v": "2.0",
    "sign_method": "md5"
}

2. 簽名生成

簽名算法： $$ text{sign} = text{md5}(text{app_secret} + text{sorted_params} + text{app_secret}) $$

def generate_sign(params, app_secret):
    param_str = ''.join([f"{k}{v}" for k,v in sorted(params.items())])
    sign_str = app_secret + param_str + app_secret
    return hashlib.md5(sign_str.encode()).hexdigest().upper()

params["sign"] = generate_sign(params, app_secret)

四、請求示例

url = "https://gw.open.1688.com/openapi/param2/2/portals.open/api/getCategory"
response = requests.get(url, params=params)

if response.status_code == 200:
    data = response.json()
    # 解析類目樹結構
    def parse_category(categories, level=0):
        for cat in categories:
            print(f"{'  '*level}[L{cat['level']}] {cat['name']} (ID:{cat['categoryId']})")
            if "children" in cat:
                parse_category(cat["children"], level+1)
    
    parse_category(data["result"]["categories"])
else:
    print(f"請求失敗: {response.status_code}")

五、返回數(shù)據(jù)結構示例

{
  "result": {
    "categories": [
      {
        "categoryId": 1,
        "name": "工業(yè)品",
        "level": 1,
        "children": [
          {
            "categoryId": 1001,
            "name": "工具",
            "level": 2,
            "isLeaf": false
          }
        ]
      }
    ]
  }
}

六、注意事項

頻率限制：單應用$QPS leq 10$，日調(diào)用量$ leq 50,000$次

緩存策略：建議本地緩存類目數(shù)據(jù)（更新周期$T geq 24h$）

錯誤代碼：

$400$：參數(shù)校驗失敗

$403$：權限不足

$500$：服務端異常

葉子類目判斷：當isLeaf=true時不可繼續(xù)下鉆

通過該接口可構建完整的類目樹結構，適用于商品發(fā)布、分類導航等場景。建議配合alibaba.category.getAttributes接口獲取類目屬性，完善商品數(shù)據(jù)體系。

有任何疑問，歡迎大家留言探討。

?審核編輯 黃宇