?

中國制造網（Made-in-China.com）作為全球知名的 B2B 電子商務平臺，匯聚了大量中國供應商和產品信息。對于希望集成其商品數據的開發者或企業而言，了解其提供的商品詳情 API 接口至關重要。本文將介紹如何通過 API 接口獲取中國制造網上的商品詳情數據。

一、 API 概述

中國制造網通常為其合作伙伴或高級會員提供 API 接口服務，用于程序化地獲取平臺上的商品信息。這些接口通常遵循 RESTful 設計原則，使用 HTTP(S) 協議進行通信，數據格式多為 JSON。核心功能是允許用戶根據商品 ID 或其他標識符，查詢并獲取商品的詳細信息。

二、 API 請求

1. 接口地址 (Endpoint)

具體的接口 URL 需要參考中國制造網官方提供的最新 API 文檔。通常其結構可能類似于： https://api.made-in-china.com/product/detail 或包含版本號如 https://api.made-in-china.com/v1/product/{productId}。

2. 請求方法 (HTTP Method)

最常用的是 GET 方法，用于查詢商品詳情。

3. 請求參數 (Request Parameters)

常見的請求參數包括：

身份驗證 (Authentication):

api_key 或 app_key: 平臺分配給開發者的唯一標識。

sign: 請求簽名，用于驗證請求的合法性。通常由 api_key, timestamp, nonce (隨機數) 和 secret_key (開發者密鑰) 按照特定規則生成。

timestamp: 請求發起的時間戳（例如 Unix 時間戳）。

nonce: 隨機字符串，用于防止重放攻擊。

商品標識 (Product Identification):

product_id: 中國制造網上商品的唯一 ID。這是獲取特定商品詳情的關鍵參數。

其他可選參數 (Optional):

fields: 指定需要返回的字段，用于控制響應數據的粒度。

language: 指定返回數據的語言（如 en, zh-CN 等）。

三、 響應結構 (Response Structure)

成功調用 API 后，通常會收到一個 JSON 格式的響應。其結構大致如下：

{
  "code": 200, // 狀態碼，200 表示成功
  "message": "Success", // 狀態信息
  "data": {
    "product_id": "123456789", // 商品ID
    "title": "High Quality Widget", // 商品標題
    "description": "Detailed description of the product...", // 商品描述
    "price": {
      "value": 10.99, // 價格數值
      "currency": "USD", // 貨幣單位
      "unit": "piece", // 價格單位 (如 /piece, /set)
      "range": "10.99 - 15.99" // 價格區間 (可選)
    },
    "min_order_quantity": 100, // 最小起訂量 (MOQ)
    "supply_ability": "100000 pieces per month", // 供應能力
    "images": [
      "https://img.made-in-china.com/product/123456789/1.jpg",
      "https://img.made-in-china.com/product/123456789/2.jpg"
    ], // 商品圖片URL列表
    "category": {
      "id": "789",
      "name": "Electronic Components"
    }, // 商品類目
    "attributes": [
      {
        "name": "Material",
        "value": "Plastic"
      },
      {
        "name": "Color",
        "value": "Black"
      }
    ], // 商品屬性/規格列表
    "seller_info": {
      "company_id": "COMP123",
      "company_name": "ABC Electronics Ltd."
    } // 賣家基本信息
    // ... 其他可能的字段，如包裝方式、港口、支付條款、認證信息等
  }
}

四、 常見問題與注意事項

官方文檔: 務必以中國制造網官方提供的最新 API 文檔為準。接口地址、參數要求、響應格式等都可能更新。

權限申請: 使用 API 通常需要向中國制造網申請開發者權限，獲得 api_key 和 secret_key。

簽名生成: 簽名 (sign) 的生成算法是保證請求安全的關鍵，必須嚴格按照文檔描述的規則計算。

頻率限制 (Rate Limiting): API 調用通常有頻率限制，需遵守規定，避免過度請求導致接口被禁用。

錯誤處理: 仔細處理 API 返回的狀態碼（非 200）和錯誤信息，如 401 Unauthorized, 403 Forbidden, 404 Not Found 等。

數據解析: 根據業務需求，正確解析 JSON 響應中的 data 對象及其嵌套字段。

圖片鏈接: 注意返回的圖片鏈接可能是相對路徑或需要拼接完整 URL。

五、 示例代碼 (Python - 概念演示)

以下是一個簡化的 Python 示例，展示如何構造請求（重點是簽名生成）。實際使用時需替換為真實的 API 地址、密鑰和參數。

import hashlib
import time
import requests
import json
import random
import string

def generate_sign(api_key, secret_key, timestamp, nonce, params=None):
    """
    生成請求簽名 (示例算法，實際需按官方文檔)
    """
    # 1. 將參數按key排序
    if params:
        param_str = '&'.join([f'{k}={v}' for k, v in sorted(params.items())])
    else:
        param_str = ''
    # 2. 拼接基礎字符串
    base_str = f"{api_key}{timestamp}{nonce}{secret_key}{param_str}"
    # 3. 計算MD5或SHA1 (根據文檔要求)
    sign = hashlib.md5(base_str.encode('utf-8')).hexdigest().upper()
    # 或 sign = hashlib.sha1(base_str.encode('utf-8')).hexdigest().upper()
    return sign

# 配置信息 (需替換為實際值)
API_ENDPOINT = "https://api.made-in-china.com/product/detail" # 假設的地址
API_KEY = "YOUR_API_KEY"
SECRET_KEY = "YOUR_SECRET_KEY"
PRODUCT_ID = "TARGET_PRODUCT_ID" # 要查詢的商品ID

# 生成隨機數和時間戳
nonce = ''.join(random.choices(string.ascii_letters + string.digits, k=8))
timestamp = str(int(time.time()))

# 構造基本請求參數
base_params = {
    'api_key': API_KEY,
    'timestamp': timestamp,
    'nonce': nonce,
    'product_id': PRODUCT_ID
}

# 生成簽名
signature = generate_sign(API_KEY, SECRET_KEY, timestamp, nonce, base_params)
base_params['sign'] = signature

# 發送GET請求
try:
    response = requests.get(API_ENDPOINT, params=base_params)
    response.raise_for_status()  # 檢查HTTP錯誤
    data = response.json()
    if data.get('code') == 200:
        product_detail = data['data']
        print("獲取商品詳情成功:")
        print(json.dumps(product_detail, indent=2, ensure_ascii=False))
    else:
        print(f"API錯誤: {data.get('code')}, {data.get('message')}")
except requests.exceptions.RequestException as e:
    print(f"請求失敗: {e}")
except json.JSONDecodeError:
    print("響應解析失敗")

六、 總結

通過中國制造網的商品詳情 API 接口，開發者可以高效、自動化地獲取平臺上的商品數據，為數據分析、競品監控、供應鏈管理、網站集成等應用提供支持。成功集成的關鍵在于仔細閱讀官方文檔、正確處理身份驗證和簽名、遵守調用規范以及妥善解析響應數據。建議在開發前聯系中國制造網獲取最新的 API 資料和支持。

?審核編輯 黃宇