?

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

一、準(zhǔn)備工作

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

注冊(cè)1688開放平臺(tái)賬號(hào)

訪問1688開放平臺(tái)官網(wǎng)，注冊(cè)開發(fā)者賬號(hào)。

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

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

獲取店鋪ID

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

在1688店鋪主頁(yè)URL中提取（如：https://shop12345678.1688.com，則shop_id=12345678）。

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

閱讀官方文檔

參考商品列表API文檔。

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

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

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

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

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

發(fā)送POST請(qǐng)求到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

請(qǐng)求方法：GET

端點(diǎn)：https://gw.open.1688.com/openapi/param2/1/com.alibaba.product/alibaba.product.getList

必需參數(shù)：

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

page_no：頁(yè)碼（從1開始）

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

access_token：上一步獲取的令牌

示例請(qǐng)求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：布爾值，表示請(qǐng)求是否成功。

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

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

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

三、完整代碼示例（Python）

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

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', '未知錯(cuò)誤')}")

# 步驟2：分頁(yè)獲取所有商品
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  # 每頁(yè)數(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)
            # 判斷是否還有下一頁(yè)
            if page_no * page_size >= total_count:
                break
            page_no += 1
        else:
            error_msg = data.get("error_message", "API調(diào)用失敗")
            raise Exception(f"錯(cuò)誤: {error_msg}, 錯(cuò)誤碼: {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)} 個(gè)")
    for idx, product in enumerate(products[:3]):  # 示例：打印前3個(gè)商品
        print(f"商品 {idx+1}: ID={product['product_id']}, 標(biāo)題={product['subject']}, 價(jià)格={product['price']}")
except Exception as e:
    print(f"程序出錯(cuò): {str(e)}")

四、注意事項(xiàng)

頻率限制：

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

分頁(yè)處理：

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

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

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

錯(cuò)誤排查：

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

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

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

五、總結(jié)

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

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

?審核編輯 黃宇