?

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

一、 API 概述

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

二、 API 請求

1. 接口地址 (Endpoint)

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

2. 請求方法 (HTTP Method)

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

3. 請求參數(shù) (Request Parameters)

常見的請求參數(shù)包括：

身份驗證 (Authentication):

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

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

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

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

商品標識 (Product Identification):

product_id: 中國制造網(wǎng)上商品的唯一 ID。這是獲取特定商品詳情的關鍵參數(shù)。

其他可選參數(shù) (Optional):

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

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

三、 響應結(jié)構(gòu) (Response Structure)

成功調(diào)用 API 后，通常會收到一個 JSON 格式的響應。其結(jié)構(gòu)大致如下：

{
  "code": 200, // 狀態(tài)碼，200 表示成功
  "message": "Success", // 狀態(tài)信息
  "data": {
    "product_id": "123456789", // 商品ID
    "title": "High Quality Widget", // 商品標題
    "description": "Detailed description of the product...", // 商品描述
    "price": {
      "value": 10.99, // 價格數(shù)值
      "currency": "USD", // 貨幣單位
      "unit": "piece", // 價格單位 (如 /piece, /set)
      "range": "10.99 - 15.99" // 價格區(qū)間 (可選)
    },
    "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"
      }
    ], // 商品屬性/規(guī)格列表
    "seller_info": {
      "company_id": "COMP123",
      "company_name": "ABC Electronics Ltd."
    } // 賣家基本信息
    // ... 其他可能的字段，如包裝方式、港口、支付條款、認證信息等
  }
}

四、 常見問題與注意事項

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

權(quán)限申請: 使用 API 通常需要向中國制造網(wǎng)申請開發(fā)者權(quán)限，獲得 api_key 和 secret_key。

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

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

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

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

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

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

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

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

def generate_sign(api_key, secret_key, timestamp, nonce, params=None):
    """
    生成請求簽名 (示例算法，實際需按官方文檔)
    """
    # 1. 將參數(shù)按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 (根據(jù)文檔要求)
    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

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

# 構(gòu)造基本請求參數(shù)
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

# 發(fā)送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("響應解析失敗")

六、 總結(jié)

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

?審核編輯 黃宇