?

一、接口基礎(chǔ)信息

接口地址
https://api.taobao.com/router/rest

請(qǐng)求方式
POST（推薦）/GET

數(shù)據(jù)格式
JSON（默認(rèn)）

二、核心參數(shù)說明

三、簽名生成算法

將所有參數(shù)按字母序排序：

params = sorted(params.items())

拼接鍵值對(duì)：

query_str = '&'.join([f"{k}{v}" for k,v in params])

追加App Secret：

raw_sign = query_str + app_secret

SHA256加密：

import hashlib
sign = hashlib.sha256(raw_sign.encode()).hexdigest().upper()

四、請(qǐng)求示例（Python）

import requests
import hashlib
import time

app_key = "YOUR_APP_KEY"
app_secret = "YOUR_SECRET"
item_id = "6789012345"

params = {
    "method": "taobao.item.get",
    "item_id": item_id,
    "fields": "title,price,pic_url,desc",
    "app_key": app_key,
    "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
    "v": "2.0"
}

# 生成簽名
sorted_params = sorted(params.items())
query_str = ''.join([f"{k}{v}" for k,v in sorted_params])
raw_sign = query_str + app_secret
sign = hashlib.sha256(raw_sign.encode()).hexdigest().upper()
params["sign"] = sign

# 發(fā)送請(qǐng)求
response = requests.post("https://api.taobao.com/router/rest", data=params)
print(response.json())

五、響應(yīng)結(jié)構(gòu)解析

{
  "item_get_response": {
    "item": {
      "title": "【正品保障】無線藍(lán)牙耳機(jī)",
      "price": "199.00",
      "pic_url": "https://img.alicdn.com/xxx.jpg",
      "desc": "商品詳細(xì)描述HTML"
    }
  }
}

六、注意事項(xiàng)

頻率限制：默認(rèn)每秒2次請(qǐng)求

字段權(quán)限：部分字段需申請(qǐng)?zhí)厥鈾?quán)限

錯(cuò)誤代碼：

7：請(qǐng)求參數(shù)缺失

15：無效簽名

27：商品不存在

提示：實(shí)際開發(fā)需遵循淘寶開放平臺(tái)最新文檔，本文示例基于2023年API版本。敏感參數(shù)已做脫敏處理，請(qǐng)?zhí)鎿Q為實(shí)際申請(qǐng)值。

?
審核編輯 黃宇