?

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

一、 API 概述

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

二、 API 請(qǐng)求

1. 接口地址 (Endpoint)

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

2. 請(qǐng)求方法 (HTTP Method)

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

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

常見(jiàn)的請(qǐng)求參數(shù)包括：

身份驗(yàn)證 (Authentication):

api_key 或 app_key: 平臺(tái)分配給開(kāi)發(fā)者的唯一標(biāo)識(shí)。

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

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

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

商品標(biāo)識(shí) (Product Identification):

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

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

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

language: 指定返回?cái)?shù)據(jù)的語(yǔ)言（如 en, zh-CN 等）。

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

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

{
  "code": 200, // 狀態(tài)碼，200 表示成功
  "message": "Success", // 狀態(tài)信息
  "data": {
    "product_id": "123456789", // 商品ID
    "title": "High Quality Widget", // 商品標(biāo)題
    "description": "Detailed description of the product...", // 商品描述
    "price": {
      "value": 10.99, // 價(jià)格數(shù)值
      "currency": "USD", // 貨幣單位
      "unit": "piece", // 價(jià)格單位 (如 /piece, /set)
      "range": "10.99 - 15.99" // 價(jià)格區(qū)間 (可選)
    },
    "min_order_quantity": 100, // 最小起訂量 (MOQ)
    "supply_ability": "100000 pieces per month", // 供應(yīng)能力
    "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."
    } // 賣家基本信息
    // ... 其他可能的字段，如包裝方式、港口、支付條款、認(rèn)證信息等
  }
}

四、 常見(jiàn)問(wèn)題與注意事項(xiàng)

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

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

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

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

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

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

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

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

以下是一個(gè)簡(jiǎn)化的 Python 示例，展示如何構(gòu)造請(qǐng)求（重點(diǎn)是簽名生成）。實(shí)際使用時(shí)需替換為真實(shí)的 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):
    """
    生成請(qǐng)求簽名 (示例算法，實(shí)際需按官方文檔)
    """
    # 1. 將參數(shù)按key排序
    if params:
        param_str = '&'.join([f'{k}={v}' for k, v in sorted(params.items())])
    else:
        param_str = ''
    # 2. 拼接基礎(chǔ)字符串
    base_str = f"{api_key}{timestamp}{nonce}{secret_key}{param_str}"
    # 3. 計(jì)算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

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

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

# 構(gòu)造基本請(qǐng)求參數(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請(qǐng)求
try:
    response = requests.get(API_ENDPOINT, params=base_params)
    response.raise_for_status()  # 檢查HTTP錯(cuò)誤
    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錯(cuò)誤: {data.get('code')}, {data.get('message')}")
except requests.exceptions.RequestException as e:
    print(f"請(qǐng)求失敗: {e}")
except json.JSONDecodeError:
    print("響應(yīng)解析失敗")

六、 總結(jié)

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

?審核編輯 黃宇