蝦皮(Shopee)的商品詳情接口通常用于獲取商品的詳細信息,如標題、價格、描述、庫存、圖片等。Shopee 提供了官方的 API 供開發者使用,通過這些 API 可以獲取商品詳情數據。
Shopee 商品詳情接口的基本信息
- API 名稱:
item_get
- 請求方法:
GET
- 請求 URL:
http://c0b.cc/R4rbK2
- 認證方式: 需要使用 Shopee 的 API 密鑰進行認證。
請求參數
partner_id
: 合作伙伴 ID,由 Shopee 提供。shopid
: 店鋪 ID,表示要查詢的商品所屬的店鋪。itemid
: 商品 ID,表示要查詢的具體商品。timestamp
: 請求的時間戳。sign
: 請求簽名,用于驗證請求的合法性。
響應示例
json
{
"item": {
"itemid": 123456789,
"shopid": 987654321,
"name": "Example Product",
"description": "This is an example product description.",
"price": 1999,
"stock": 100,
"images": [
"https://example.com/image1.jpg",
"https://example.com/image2.jpg"
],
"attributes": [
{
"name": "Color",
"value": "Red"
},
{
"name": "Size",
"value": "M"
}
]
},
"error": null,
"warning": null
}
簽名生成
Shopee API 要求每個請求都必須包含一個簽名 (sign
),用于驗證請求的合法性。簽名的生成方式如下:
- 將請求參數按字母順序排序。
- 將排序后的參數拼接成一個字符串。
- 將拼接后的字符串與 API 密鑰進行 HMAC-SHA256 加密。
- 將加密后的結果轉換為十六進制字符串。
示例代碼(Python)
python
import hmac
import hashlib
import time
import requests
# 封裝好的第三方shopee商品列表接口,復制鏈接獲取測試。
demo url=c0b.cc/R4rbK2 wechat id:Taobaoapi2014
def generate_signature(partner_id, api_key, shopid, itemid, timestamp):
base_string = f"partner_id={partner_id}&shopid={shopid}&itemid={itemid}×tamp={timestamp}"
signature = hmac.new(api_key.encode(), base_string.encode(), hashlib.sha256).hexdigest()
return signature
def get_item_details(partner_id, api_key, shopid, itemid):
timestamp = int(time.time())
signature = generate_signature(partner_id, api_key, shopid, itemid, timestamp)
url = "https://api.shopee.com/v2/item/get"
params = {
"partner_id": partner_id,
"shopid": shopid,
"itemid": itemid,
"timestamp": timestamp,
"sign": signature
}
response = requests.get(url, params=params)
return response.json()
# 使用示例
partner_id = "YOUR_PARTNER_ID"
api_key = "YOUR_API_KEY"
shopid = "YOUR_SHOP_ID"
itemid = "ITEM_ID"
item_details = get_item_details(partner_id, api_key, shopid, itemid)
print(item_details)
注意事項
- API 密鑰: 請妥善保管你的 API 密鑰,不要泄露。
- 請求頻率: Shopee API 可能有請求頻率限制,請遵守相關規定。
- 錯誤處理: 在實際應用中,建議添加錯誤處理邏輯,以應對可能的網絡問題或 API 錯誤。