蝦皮(Shopee)的商品詳情接口通常用于獲取商品的詳細(xì)信息,如標(biāo)題、價(jià)格、描述、庫(kù)存、圖片等。Shopee 提供了官方的 API 供開發(fā)者使用,通過這些 API 可以獲取商品詳情數(shù)據(jù)。
Shopee 商品詳情接口的基本信息
- API 名稱:
item_get
- 請(qǐng)求方法:
GET
- 請(qǐng)求 URL:
http://c0b.cc/R4rbK2
- 認(rèn)證方式: 需要使用 Shopee 的 API 密鑰進(jìn)行認(rèn)證。
請(qǐng)求參數(shù)
partner_id
: 合作伙伴 ID,由 Shopee 提供。shopid
: 店鋪 ID,表示要查詢的商品所屬的店鋪。itemid
: 商品 ID,表示要查詢的具體商品。timestamp
: 請(qǐng)求的時(shí)間戳。sign
: 請(qǐng)求簽名,用于驗(yàn)證請(qǐng)求的合法性。
響應(yīng)示例
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 要求每個(gè)請(qǐng)求都必須包含一個(gè)簽名 (sign
),用于驗(yàn)證請(qǐng)求的合法性。簽名的生成方式如下:
- 將請(qǐng)求參數(shù)按字母順序排序。
- 將排序后的參數(shù)拼接成一個(gè)字符串。
- 將拼接后的字符串與 API 密鑰進(jìn)行 HMAC-SHA256 加密。
- 將加密后的結(jié)果轉(zhuǎn)換為十六進(jìn)制字符串。
示例代碼(Python)
python
import hmac
import hashlib
import time
import requests
# 封裝好的第三方shopee商品列表接口,復(fù)制鏈接獲取測(cè)試。
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)
注意事項(xiàng)
- API 密鑰: 請(qǐng)妥善保管你的 API 密鑰,不要泄露。
- 請(qǐng)求頻率: Shopee API 可能有請(qǐng)求頻率限制,請(qǐng)遵守相關(guān)規(guī)定。
- 錯(cuò)誤處理: 在實(shí)際應(yīng)用中,建議添加錯(cuò)誤處理邏輯,以應(yīng)對(duì)可能的網(wǎng)絡(luò)問題或 API 錯(cuò)誤。