?

在1688平臺（阿里巴巴旗下的B2B批發(fā)平臺）上，開發(fā)者可以通過開放API獲取指定店鋪的所有商品信息。這常用于數(shù)據(jù)集成、庫存管理或電商分析場景。以下是一篇技術(shù)貼，我將逐步介紹實現(xiàn)方法，包括注冊、API調(diào)用和代碼示例。內(nèi)容基于1688開放平臺的真實API文檔，確?？煽啃院蛯嵱眯?。

一、準(zhǔn)備工作

在調(diào)用API前，需完成以下步驟：

注冊1688開放平臺賬號

訪問1688開放平臺官網(wǎng)，注冊開發(fā)者賬號。

創(chuàng)建應(yīng)用（Application），獲取App Key和App Secret。這些是API認(rèn)證的關(guān)鍵憑證。

注意：應(yīng)用需審核通過才能正式使用API。

獲取店鋪ID

目標(biāo)店鋪的ID（shop_id）是必需的?？赏ㄟ^以下方式獲?。?/p>

在1688店鋪主頁URL中提?。ㄈ纾篽ttps://shop12345678.1688.com，則shop_id=12345678）。

使用1688搜索API查詢店鋪名稱。

閱讀官方文檔

參考商品列表API文檔。

核心API端點：/param2/1/com.alibaba.product/alibaba.product.getList，支持分頁獲取商品數(shù)據(jù)。

二、API調(diào)用步驟

以下是獲取店鋪所有商品的核心流程：

認(rèn)證授權(quán)

使用OAuth 2.0獲取access_token（令牌）。

發(fā)送POST請求到https://gw.open.1688.com/openapi/http/1/system.oauth2/getToken，參數(shù)包括：

grant_type=client_credentials

client_id={App Key}

client_secret={App Secret}

響應(yīng)中提取access_token，有效期通常為1天。

調(diào)用商品列表API

請求方法：GET

端點：https://gw.open.1688.com/openapi/param2/1/com.alibaba.product/alibaba.product.getList

必需參數(shù)：

shop_id：目標(biāo)店鋪ID

page_no：頁碼（從1開始）

page_size：每頁商品數(shù)量（建議設(shè)為20-100）

access_token：上一步獲取的令牌

示例請求URL：

https://gw.open.1688.com/openapi/param2/1/com.alibaba.product/alibaba.product.getList?shop_id=12345678&page_no=1&page_size=50&access_token=your_access_token  

處理響應(yīng)數(shù)據(jù)

響應(yīng)格式為JSON，包含：

success：布爾值，表示請求是否成功。

result：商品列表數(shù)組，每個商品包含product_id、subject（標(biāo)題）、price等字段。

total_count：店鋪商品總數(shù)，用于分頁控制。

錯誤處理：檢查error_code和error_message，常見錯誤如認(rèn)證失敗或參數(shù)無效。

三、完整代碼示例（Python）

以下Python代碼演示如何獲取店鋪所有商品（需安裝requests庫）：

import requests

# 替換為你的憑證和店鋪ID
app_key = "your_app_key"
app_secret = "your_app_secret"
shop_id = "target_shop_id"  # 例如："12345678"

# 步驟1：獲取access_token
def get_access_token(app_key, app_secret):
    token_url = "https://gw.open.1688.com/openapi/http/1/system.oauth2/getToken"
    params = {
        "grant_type": "client_credentials",
        "client_id": app_key,
        "client_secret": app_secret
    }
    response = requests.post(token_url, params=params)
    data = response.json()
    if "access_token" in data:
        return data["access_token"]
    else:
        raise Exception(f"獲取token失敗: {data.get('error_message', '未知錯誤')}")

# 步驟2：分頁獲取所有商品
def get_all_products(shop_id, access_token):
    base_url = "https://gw.open.1688.com/openapi/param2/1/com.alibaba.product/alibaba.product.getList"
    page_no = 1
    page_size = 50  # 每頁數(shù)量
    all_products = []
    
    while True:
        params = {
            "shop_id": shop_id,
            "page_no": page_no,
            "page_size": page_size,
            "access_token": access_token
        }
        response = requests.get(base_url, params=params)
        data = response.json()
        
        if data.get("success"):
            products = data["result"].get("product_list", [])
            all_products.extend(products)
            total_count = data["result"].get("total_count", 0)
            # 判斷是否還有下一頁
            if page_no * page_size >= total_count:
                break
            page_no += 1
        else:
            error_msg = data.get("error_message", "API調(diào)用失敗")
            raise Exception(f"錯誤: {error_msg}, 錯誤碼: {data.get('error_code')}")
    
    return all_products

# 主函數(shù)
try:
    access_token = get_access_token(app_key, app_secret)
    products = get_all_products(shop_id, access_token)
    print(f"成功獲取店鋪 {shop_id} 的所有商品，共 {len(products)} 個")
    for idx, product in enumerate(products[:3]):  # 示例：打印前3個商品
        print(f"商品 {idx+1}: ID={product['product_id']}, 標(biāo)題={product['subject']}, 價格={product['price']}")
except Exception as e:
    print(f"程序出錯: {str(e)}")

四、注意事項

頻率限制：

1688 API有調(diào)用頻率限制（如每分鐘100次）。超出會導(dǎo)致錯誤，建議添加延時（如time.sleep(1)）。

分頁處理：

店鋪商品可能成千上萬，務(wù)必使用分頁（page_no和page_size）。代碼中已實現(xiàn)自動遍歷所有頁。

數(shù)據(jù)字段：

響應(yīng)中的商品字段參考文檔，常用包括product_id、subject、price、image_url等?？筛鶕?jù)需求篩選。

錯誤排查：

認(rèn)證失?。簷z查App Key/Secret是否有效或過期。

無效shop_id：確認(rèn)店鋪是否存在或未授權(quán)。

響應(yīng)延遲：添加重試機制（如retry庫）。

五、總結(jié)

通過1688的alibaba.product.getList API，開發(fā)者可以高效獲取店鋪所有商品數(shù)據(jù)。核心步驟包括：注冊開放平臺、獲取店鋪ID、認(rèn)證授權(quán)、分頁調(diào)用API和處理響應(yīng)。以上代碼可直接集成到電商系統(tǒng)中，用于自動化數(shù)據(jù)同步或分析。建議在實際使用前測試沙箱環(huán)境，并遵守1688的API使用協(xié)議。

如需進一步優(yōu)化（如異步請求或數(shù)據(jù)存儲），歡迎在評論區(qū)討論！

?審核編輯 黃宇