一、接入前準(zhǔn)備（必須完成）

1. 注冊(cè)與認(rèn)證（賬號(hào)與資質(zhì)）

訪問 MIC 開放平臺(tái)：https://open.made-in-china.com/

用企業(yè)賬號(hào)注冊(cè) / 登錄（個(gè)人賬號(hào)權(quán)限受限，跨境 / 商品類接口多為企業(yè)專屬）

完成企業(yè)實(shí)名認(rèn)證：營(yíng)業(yè)執(zhí)照、法人信息、對(duì)公賬戶核驗(yàn)（1–3 個(gè)工作日）

開通API 服務(wù)權(quán)限：在控制臺(tái)「API 服務(wù)」→「申請(qǐng)開通」，選擇你需要的能力包（商品搜索、商品詳情、類目、榜單等）

2. 創(chuàng)建應(yīng)用，獲取核心憑證

進(jìn)入「應(yīng)用管理」→「創(chuàng)建應(yīng)用」

應(yīng)用名稱：自定義（如 “MIC 商品數(shù)據(jù)工具”）

應(yīng)用類型：自用型 / 第三方應(yīng)用（自用即可）

回調(diào) URL：OAuth 授權(quán)用，本地調(diào)試可填 http://localhost

審核通過后，在應(yīng)用詳情頁獲取三大核心憑證（務(wù)必妥善保管，嚴(yán)禁泄露）

app_key / client_id：應(yīng)用唯一標(biāo)識(shí)

app_secret / client_secret：簽名密鑰

access_token：接口調(diào)用令牌（通過 OAuth 獲取，有效期通常 24 小時(shí)）

3. 申請(qǐng)接口權(quán)限

進(jìn)入「權(quán)限管理」→「申請(qǐng) API 權(quán)限」

搜索并勾選你需要的接口（以商品 / 類目 / 榜單為例）：

商品類目：category.get（獲取類目樹）

商品搜索 / 榜單：product.search、product.topList

商品詳情：product.get

提交審核，公開權(quán)限一般即時(shí)通過，高階權(quán)限可能 1–2 個(gè)工作日。

二、核心技術(shù)流程：鑒權(quán)與簽名（MIC 通用規(guī)則）

MIC 接口采用OAuth2.0 + MD5 簽名雙重校驗(yàn)，所有請(qǐng)求必須帶合法簽名與令牌。

1. 獲取 access_token（授權(quán)流程）

（1）獲取授權(quán)碼 code

plaintext

GET https://open.made-in-china.com/oauth/authorize
?client_id=你的app_key
&redirect_uri=你的回調(diào)URL
&response_type=code
&state=隨機(jī)字符串(防CSRF)

用戶授權(quán)后，平臺(tái)會(huì)重定向到你的redirect_uri并帶回code。

（2）用 code 換取 access_token

plaintext

POST https://open.made-in-china.com/oauth/token
Content-Type: application/x-www-form-urlencoded

grant_type=authorization_code
&client_id=你的app_key
&client_secret=你的app_secret
&code=上一步獲取的code
&redirect_uri=你的回調(diào)URL

返回示例（JSON）：

json

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expires_in": 86400,
  "refresh_token": "xxx...",
  "token_type": "bearer"
}

2. 生成簽名（MD5，必對(duì)）

簽名規(guī)則（與 1688 類似，但參數(shù)拼接略有差異）：

把所有非空請(qǐng)求參數(shù)（不含sign、不含文件）按參數(shù)名 ASCII 升序排列

按 key1=value1&key2=value2&... 拼接成字符串

首尾拼接 app_secret：app_secret + 參數(shù)字符串 + app_secret

做 MD5 加密，轉(zhuǎn)大寫，得到sign

示例（Python）：

python

運(yùn)行

import hashlib

def generate_mic_sign(params, app_secret):
    # 1. 按key升序排序
    sorted_items = sorted(params.items(), key=lambda x: x[0])
    # 2. 拼接 key=value&key=value...
    param_str = "&".join([f"{k}={v}" for k, v in sorted_items if v is not None])
    # 3. 首尾加secret
    sign_raw = app_secret + param_str + app_secret
    # 4. MD5大寫
    sign = hashlib.md5(sign_raw.encode("utf-8")).hexdigest().upper()
    return sign

三、接口調(diào)用實(shí)戰(zhàn)（以 “獲取商品類目 + 類目榜單” 為例）

1. 通用請(qǐng)求規(guī)范

請(qǐng)求地址：https://api.made-in-china.com/rest/{version}/{interface}

版本：v1 或 v2（以文檔為準(zhǔn)，目前主流v2）

請(qǐng)求方式：GET（查詢類）/POST（提交類）

必傳公共參數(shù)（所有接口都要）：

2. 接口 1：獲取商品類目樹（category.get）

請(qǐng)求示例（Python）

python

運(yùn)行

import requests
import time
import uuid

# 配置
APP_KEY = "你的app_key"
APP_SECRET = "你的app_secret"
ACCESS_TOKEN = "你的access_token"
API_URL = "https://api.made-in-china.com/rest/v2/category.get"

def get_mic_category_tree(parent_id=0):
    # 業(yè)務(wù)參數(shù)
    params = {
        "app_key": APP_KEY,
        "timestamp": int(time.time() * 1000),
        "nonce": str(uuid.uuid4()),
        "access_token": ACCESS_TOKEN,
        "parent_id": parent_id,  # 0=頂級(jí)類目
        "format": "json"
    }
    # 生成簽名
    params["sign"] = generate_mic_sign(params, APP_SECRET)
    # 發(fā)送請(qǐng)求
    resp = requests.get(API_URL, params=params, timeout=10)
    return resp.json()

# 調(diào)用：獲取頂級(jí)類目
if __name__ == "__main__":
    result = get_mic_category_tree(parent_id=0)
    print(result)

響應(yīng)結(jié)構(gòu)（關(guān)鍵字段）

json

{
  "code": 200,
  "message": "success",
  "data": {
    "categories": [
      {
        "category_id": "1001",
        "name": "Apparel",
        "level": 1,
        "is_leaf": false,
        "children": [...]
      }
    ]
  }
}

3. 接口 2：按類目獲取商品榜單（product.topList）

業(yè)務(wù)參數(shù)（核心）

category_id：類目 ID（從上一步獲取）

sort_type：排序類型（sales = 銷量，price = 價(jià)格，newest = 新品）

page_no / page_size：分頁

country：目標(biāo)市場(chǎng)（可選，如 US、DE）

調(diào)用示例（關(guān)鍵代碼）

python

運(yùn)行

API_TOP_URL = "https://api.made-in-china.com/rest/v2/product.topList"

def get_category_top_products(category_id, sort_type="sales", page_no=1, page_size=20):
    params = {
        "app_key": APP_KEY,
        "timestamp": int(time.time() * 1000),
        "nonce": str(uuid.uuid4()),
        "access_token": ACCESS_TOKEN,
        "category_id": category_id,
        "sort_type": sort_type,
        "page_no": page_no,
        "page_size": page_size,
        "format": "json"
    }
    params["sign"] = generate_mic_sign(params, APP_SECRET)
    resp = requests.get(API_TOP_URL, params=params, timeout=10)
    return resp.json()

四、限流、異常與最佳實(shí)踐

1. 限流規(guī)則（必須遵守）

國(guó)內(nèi) IP：QPS ≤ 10

海外 IP：QPS ≤ 5

單日調(diào)用限額：基礎(chǔ)權(quán)限一般 5000–10000 次，企業(yè)版可提升

觸發(fā)限流返回429 Too Many Requests，需做退避重試（1s→3s→5s，最多 3 次）

2. 常見錯(cuò)誤碼與處理

3. 生產(chǎn)優(yōu)化建議

緩存類目數(shù)據(jù)：類目更新慢，本地緩存 24 小時(shí)，減少調(diào)用

令牌池 / 自動(dòng)刷新：提前刷新access_token，避免過期中斷

字段過濾：用fields參數(shù)只返回需要的字段，提升性能

日志與監(jiān)控：記錄請(qǐng)求耗時(shí)、成功率、錯(cuò)誤碼，便于排查

五、與 1688 接口的關(guān)鍵差異（避坑）

授權(quán)體系：MIC 強(qiáng)依賴access_token，1688 部分公開接口可僅用簽名

參數(shù)拼接：MIC 用key=value&分隔，1688 是直接keyvalue無分隔符

限流粒度：MIC 按 IP 地域區(qū)分 QPS，1688 按應(yīng)用維度

類目結(jié)構(gòu)：MIC 類目 ID 為字符串，層級(jí)用level顯式標(biāo)注，更適合跨境場(chǎng)景

六、下一步行動(dòng)

先在 MIC 開放平臺(tái)完成企業(yè)認(rèn)證 + 應(yīng)用創(chuàng)建 + 權(quán)限申請(qǐng)

用 Postman 先調(diào)試category.get，拿到類目 ID

再調(diào)用product.topList，驗(yàn)證類目榜單數(shù)據(jù)

最后集成到你的系統(tǒng)，加上緩存、限流、異常兜底

審核編輯 黃宇