获取中国制造网商品详情数据的 API 接口指南

​

中国制造网（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 资料和支持。

​审核编辑 黄宇