使用Python開發獲取商品銷量詳情API介面

API_Zevin發表於2024-12-09
PythonAPI

在現代軟體開發中，API（應用程式程式設計介面）已成為不同軟體間互動的橋樑。尤其在電商領域，API介面使得開發者能夠訪問和操作電商平臺上的資料，如商品詳情、使用者評價、訂單資訊等。本文將詳細介紹如何使用Python開發一個獲取商品銷量詳情的API介面。

一、API介面概述

API（Application Programming Interface）是現代軟體開發中的重要工具，它允許開發者透過預定義的介面呼叫和操作其他系統或平臺的功能和資料。在電商領域，API介面使得開發者能夠訪問電商平臺上的商品資料，包括銷量、價格、評價等，這對於商品推薦、市場分析等應用場景非常有價值。

二、技術選型

  • Flask與FastAPI：Flask和FastAPI是Python中常用的Web框架，用於建立API介面。Flask是一個輕量級的Web框架，適合小型專案。而FastAPI則以其高效能和簡潔的程式碼結構受到青睞，它還支援自動生成文件，方便除錯和測試。
  • 資料庫：雖然本文示例中使用了字典模擬資料庫，但在實際應用中，通常會使用真實的資料庫（如MySQL、MongoDB等）來儲存和獲取商品資料。
  • 第三方API：如果需要從電商平臺獲取商品資料，還可以使用電商平臺提供的API，如淘寶開放平臺API。

三、開發步驟

1. 環境準備

首先，確保你的Python環境已經安裝了必要的庫。如果你打算使用Flask或FastAPI，可以透過pip安裝：

bash
    pip install flask
    # 或者
    pip install fastapi uvicorn

如果你需要從淘寶等電商平臺獲取資料，還需要安裝requests庫：

bash
    pip install requests

2. 建立Flask API介面

下面是一個使用Flask框架建立簡單API介面的示例程式碼，用於讀取模擬的商品銷量詳情資料。

python
    from flask import Flask, jsonify
     
    app = Flask(__name__)
     
    # 模擬商品詳情資料，實際中可從資料庫獲取
    products = {
        "1": {
            "name": "示例商品1",
            "description": "這是一款示例商品，具有不錯的功能。",
            "category": "電子產品",
            "sales": 1000  # 模擬銷量資料
        },
        "2": {
            "name": "示例商品2",
            "description": "另一個示例商品，很實用。",
            "category": "生活用品",
            "sales": 500  # 模擬銷量資料
        }
    }
     
    @app.route('/product/<product_id>', methods=['GET'])
    def get_product_detail(product_id):
        """根據商品ID獲取商品詳情的介面函式"""
        product = products.get(product_id)
        if product:
            return jsonify(product)
        return jsonify({"message": "未找到該商品"}), 404
     
    if __name__ == '__main__':
        app.run(debug=True)

在上面的程式碼中，我們建立了一個Flask應用例項，並定義了一個名為products的字典來模擬商品詳情資料。透過@app.route裝飾器定義了一個路由/product/<product_id>，當客戶端發起GET請求到這個路徑時，get_product_detail函式會被呼叫，返回對應商品的詳細資訊。

3. 建立FastAPI API介面

下面是一個使用FastAPI框架建立類似功能的API介面的示例程式碼。

python
    from fastapi import FastAPI
     
    app = FastAPI()
     
    # 模擬商品詳情資料，實際中可從資料庫獲取
    products = {
        "1": {
            "name": "示例商品1",
            "description": "這是一款示例商品，具有不錯的功能。",
            "category": "電子產品",
            "sales": 1000  # 模擬銷量資料
        },
        "2": {
            "name": "示例商品2",
            "description": "另一個示例商品，很實用。",
            "category": "生活用品",
            "sales": 500  # 模擬銷量資料
        }
    }
     
    @app.get("/product/{product_id}")
    async def get_product_detail(product_id: str):
        """根據商品ID獲取商品詳情的介面函式"""
        product = products.get(product_id)
        if product:
            return product
        return {"message": "未找到該商品"}

執行FastAPI應用可以使用uvicorn：

bash
    uvicorn main:app --reload

在上面的程式碼中，我們建立了一個FastAPI應用例項，並定義了一個路由/product/{product_id}。當客戶端發起GET請求到這個路徑時，get_product_detail函式會被呼叫，返回對應商品的詳細資訊。

4. 呼叫淘寶開放平臺API

如果你需要從淘寶等電商平臺獲取商品銷量資料，可以使用電商平臺提供的API。下面是一個使用Python呼叫淘寶商品詳情API的示例程式碼。

首先，你需要在淘寶開放平臺註冊一個開發者賬號，並建立應用以獲取API金鑰（App Key和App Secret）。

python
    import requests
    import hashlib
    import time
    import urllib.parse
     
    APP_KEY = 'your_app_key'
    APP_SECRET = 'your_app_secret'
     
    def generate_sign(params, app_secret):
        """生成淘寶API簽名"""
        params_str = ''.join(sorted(['%s%s' % (k, v) for k,
v in params.items() if k not in ['sign', 'sign_method']]))
        sign = hashlib.md5((params_str + app_secret).encode('utf-8')).hexdigest().upper()
        params['sign'] = sign
        return params
     
    def taobao_item_get(item_id):
        """呼叫淘寶商品詳情API"""
        url = 'https://eco.taobao.com/router/rest'
        params = {
            'method': 'taobao.item.get',
            'v': '2.0',
            'format': 'json',
            'sign_method': 'md5',
            'timestamp': int(time.time()),
            'item_id': item_id  # 商品ID
        }
        params = generate_sign(params, APP_SECRET)
        response = requests.get(url, params=params)
        return response.json()
     
    # 示例呼叫
    item_id = '1234567890'  # 替換為實際的商品ID
    result = taobao_item_get(item_id)
     
    # 解析返回值
    if 'error_response' in result:
        print(f"Error: {result['error_response']['msg']}")
    else:
        item = result['item']
        print(f"商品標題: {item['title']}")
        print(f"商品價格: {item['price']}")
        print(f"商品圖片: {item['pic_url']}")
        # 注意：淘寶API返回的商品銷量資料可能不在返回的頂層結構中，需要根據具體API文件解析

在上面的程式碼中，我們設定了必要的引數，包括App Key、App Secret、商品ID等，然後生成了簽名，並構造了請求URL。透過傳送GET請求，我們獲取了API的響應資料，並解析了商品的標題、價格、圖片URL等資訊。

四、注意事項

  • 資料庫連線：在實際應用中，商品資料通常儲存在資料庫中，而不是字典中。你需要連線資料庫來獲取和儲存資料。
  • API許可權：在使用第三方API時，需要申請相應的API許可權，並遵守使用規範。
  • 錯誤處理：在開發API介面時，需要新增錯誤處理邏輯，以處理各種異常情況，如引數驗證失敗、資料庫查詢失敗等。
  • 安全性：確保API介面的安全性，避免敏感資訊洩露。可以使用HTTPS、身份驗證、許可權控制等技術手段來提高安全性。
  • 效能最佳化：對於高併發的API介面，需要進行效能最佳化，如使用快取、最佳化資料庫查詢等。
  • 文件和測試：為API介面編寫詳細的文件，方便其他開發者使用。同時，需要進行充分的測試，確保API介面的穩定性和正確性。

五、總結

本文介紹瞭如何使用Python開發獲取商品銷量詳情的API介面。我們選擇了Flask和FastAPI兩個常用的Web框架進行示例，並展示瞭如何呼叫淘寶開放平臺API來獲取商品資料。在實際應用中，你需要根據具體需求和技術選型進行開發和最佳化。希望本文能為你提供一些有用的參考和幫助。

相關文章