?

引言 在電商系統開發、價格監控、競品分析等場景中，獲取準確、實時的商品詳情數據至關重要。沃爾瑪作為全球零售巨頭，提供了強大的開放 API 接口供開發者使用。本文將詳細介紹如何通過沃爾瑪平臺的 Get a Walmart Item API 接口來獲取單個商品的詳細信息，并附帶 Python 示例代碼。

一、接口概述與認證準備

接口功能：Get a Walmart Item API 允許開發者根據沃爾瑪的商品 ID (通常稱為 itemId 或 usItemId) 查詢該商品的完整詳情信息，包括標題、描述、價格、圖片、規格、庫存狀態等。

認證方式：調用沃爾瑪 API 需要使用 OAuth 2.0 認證。開發者需要在 沃爾瑪開發者門戶 注冊賬號，創建應用并獲取以下關鍵憑證：

Client ID

Client Secret

獲取訪問令牌 (Access Token)：在調用商品詳情 API 前，需要先用 Client ID 和 Client Secret 換取一個有效的 access_token。通常通過向認證端點發送請求實現。

二、調用 Get a Walmart Item API

API 端點 (Endpoint)：

https://developer.api.walmart.com/api-proxy/service/affiliate/product/v2/items/{itemId}

將 {itemId} 替換為你要查詢的具體沃爾瑪商品 ID。

請求方法： GET

必需請求頭：

Authorization: Bearer {access_token} (將 {access_token} 替換為實際獲取到的令牌)

Accept: application/json (表示期望接收 JSON 格式的響應)

可選查詢參數：

通常此接口不需要額外參數即可獲取核心詳情，但具體支持參數需參考最新官方文檔。

三、處理響應數據

API 成功調用后，會返回一個結構化的 JSON 對象。其核心結構通常包含：

itemId: 商品唯一標識符。

name: 商品名稱。

salePrice: 當前售價。

shortDescription / longDescription: 商品短描述和長描述。

brandName: 品牌名稱。

thumbnailImage: 商品縮略圖 URL。

productUrl: 商品在沃爾瑪官網的頁面 URL。

stock: 庫存狀態。

attributes: 包含商品規格、重量、尺寸等詳細屬性的列表。

imageEntities: 包含商品多角度展示圖片 URL 的列表。

開發者需要根據業務需求解析這個 JSON 對象，提取所需字段。

四、Python 代碼示例

import requests

# 替換為你的實際憑證和商品ID
CLIENT_ID = 'your_client_id'
CLIENT_SECRET = 'your_client_secret'
ITEM_ID = '123456789'  # 示例商品ID
ACCESS_TOKEN_URL = 'https://developer.api.walmart.com/api-proxy/service/affiliate/token/v2/get'
ITEM_API_URL = f'https://developer.api.walmart.com/api-proxy/service/affiliate/product/v2/items/{ITEM_ID}'

# 步驟 1: 獲取 Access Token (簡化示例，實際需處理錯誤和令牌刷新)
auth_response = requests.post(ACCESS_TOKEN_URL, auth=(CLIENT_ID, CLIENT_SECRET))
if auth_response.status_code == 200:
    access_token = auth_response.json().get('access_token')
else:
    print(f"獲取Token失敗: {auth_response.status_code}, {auth_response.text}")
    exit(1)

# 步驟 2: 設置請求頭，調用商品詳情API
headers = {
    'Authorization': f'Bearer {access_token}',
    'Accept': 'application/json'
}

item_response = requests.get(ITEM_API_URL, headers=headers)

# 步驟 3: 處理響應
if item_response.status_code == 200:
    item_data = item_response.json()
    # 解析你需要的數據，例如：
    item_name = item_data.get('name')
    item_price = item_data.get('salePrice')
    print(f"商品名稱: {item_name}")
    print(f"銷售價格: ${item_price}")
    # 可以進一步解析 attributes, images 等
else:
    print(f"獲取商品詳情失敗: {item_response.status_code}, {item_response.text}")

五、關鍵注意事項

速率限制 (Rate Limiting)：沃爾瑪 API 對調用頻率有嚴格限制。務必遵守官方文檔規定的速率限制，并在代碼中實現適當的延時或重試邏輯，避免觸發限流導致服務不可用。

錯誤處理：完善處理各種 HTTP 狀態碼（如 401 Unauthorized, 404 Not Found, 429 Too Many Requests）和網絡異常。

訪問令牌管理：access_token 有有效期，需要實現邏輯在令牌過期前刷新或重新獲取。

數據解析：響應 JSON 結構可能復雜且嵌套較深，確保準確解析所需字段，注意處理可能缺失的數據。

官方文檔：API 細節可能更新，務必以 沃爾瑪開發者門戶 提供的最新官方文檔為準。

六、總結

通過沃爾瑪的 Get a Walmart Item API，開發者能夠高效地接入豐富的商品數據，為各類電商應用提供強大的數據支撐。理解認證流程、掌握 API 調用方法、正確處理響應并遵守平臺規則是成功集成的關鍵。希望本文能助你快速上手沃爾瑪商品數據的獲取工作。

提示：在實際使用前，請務必仔細閱讀沃爾瑪 API 的官方文檔和使用條款，了解最新的接口規范、認證方式和限制條件。

?審核編輯 黃宇