💰 1688开放平台「免费」与「付费」接口全清单对比（附Python源码）

一、1688 API 费用分层速览

✅ 中小企业在ERP中做商品主数据同步 + 自动建采购单 + 发货回写 = L1 零成本

二、免费 vs 付费接口全清单对比

✅ L1 免费接口（无需购买任何包）

💰 L2 资源包（付费提频/开进阶普通增值）

💰 L3 增值服务（需单独购买增值包）

三、Python：免费/付费接口探测脚本（判断你是否踩付费墙）

# ali1688_free_vs_paid_check.py
"""
探测脚本：
 1. 调免费接口 alibaba.item.get → 期望成功
 2. 调增值接口 alibaba.product.stock.get(实时库存) → 期望 403(未购)
若免费接口也403 → 检查 AppKey/Secret/OfferId
若增值接口返回数据 → 你已购增值包
"""
import hashlib
import time
import requests
import urllib.parse
from typing import Tuple, Optional
# 封装好API供应商demo url=https://console.open.onebound.cn/console/?i=Lex
class _ProbeClient:
    def __init__(self, ak, as_, tk=None):
        self.ak, self.as_, self.tk = ak, as_, tk

    def _sign(self, p: dict) -> str:
        f = sorted((k,v) for k,v in p.items()
                   if v is not None and str(v).strip()!='' and k!='sign')
        s = ''.join(f"{k}{v}" for k,v in f)
        return hashlib.md5(f"{self.as_}{s}{self.as_}".encode()).hexdigest().upper()

    def _call(self, url, method, biz):
        p = {"method":method,"app_key":self.ak,"timestamp":str(int(time.time()*1000)),
             "format":"json","v":"2.0","sign_method":"md5"}
        if self.tk: p["session"]=self.tk
        p["param2" if "param2" in url or method=="alibaba.offer.search"
                    else "param"] = urllib.parse.quote_plus(str(biz).replace("'",'"'))
        p["sign"]=self._sign(p)
        r=requests.get(url,params=p,timeout=15)
        r.raise_for_status()
        d=r.json()
        if "error_response" in d:
            return None, (str(d["error_response"].get("code","")),
                           d["error_response"].get("msg",""))
        k=[x for x in d if x!="error_response"][0]
        return d[k], None

def check_free_paid(ak, as_, tk, offer_id="612345678901"):
    c = _ProbeClient(ak, as_, tk)
    gw = "https://gw.open.1688.com/openapi/http/2/1"
    print("="*50)
    print("🔎 1688 免费 vs 付费接口探测")
    print("="*50)

    # ── ① 免费 ──
    print("\n① 测试 FREE → alibaba.item.get")
    res, err = c._call(gw, "alibaba.item.get", {"item_id":offer_id, "fields":"item_id,title"})
    if err:
        print(f"   ❌ 免费接口异常 [{err[0]}]: {err[1]}")
        print("   → 确认 AppKey/AppSecret 正确且 offer_id 存在")
    else:
        title = res.get("alibaba_item_get_response",{}).get("item",{}).get("title","")
        print(f"   ✅ 免费接口正常！商品:{title[:20] if title else 'OK'}")

    # ── ② 增值(实时库存) ──
    print("\n② 测试 PAID → alibaba.product.stock.get (实时库存锁定)")
    res, err = c._call(gw, "alibaba.product.stock.get", {"offer_id": offer_id})
    if err:
        cd,msg=err
        if "403" in cd or "permission" in msg.lower():
            print(f"   ⚠️  返回 403 — 这是正常的：**该接口属增值服务，未购买**")
            print("   → 如需：登录 open.1688.com → 服务市场 → 购「实时库存/增值包」")
            print("   → 免费替代：用 alibaba.item.get 返回的 sku_list[].amount_on_sale 作库存快照")
        else:
            print(f"   ❓ 其他错误 [{cd}]: {msg}")
    else:
        print("   ✅ 增值包已开通！实时库存:", res)

    print("\n📋 小结：")
    print("   • 商品/订单/物流 = L1 免费，直接用于ERP对接 ✅")
    print("   • QPS不足 → 买 L2 资源包（仍免费调用，仅提频+开高级快照）")
    print("   • 实时库存锁定/跨境增值/推送 = L3 需购增值包 💰")
    print("="*50)

# =================== 运行 ===================
if __name__=="__main__":
    check_free_paid(
        ak="YOUR_APP_KEY",
        as_="YOUR_APP_SECRET",
        tk="YOUR_ACCESS_TOKEN",      # 商品可不传；订单类需传
        offer_id="612345678901"      # 替换真实商品ID测连通
    )

② 测试 PAID → alibaba.product.stock.get (实时库存锁定)
   ⚠️  返回 403 — 这是正常的：**该接口属增值服务，未购买**
   → 如需：登录 open.1688.com → 服务市场 → 购「实时库存/增值包」
   → 免费替代：用 alibaba.item.get 返回的 sku_list[].amount_on_sale 作库存快照

四、什么时候才需要付费？

五、一句话面试/方案总结

1688开放平台商品/订单/物流API调用免费（L1），QPS受限；实时库存锁定、跨境增值、数据推送、ISV代发属L3增值包需购买，未购调对应接口返回403。sku_list[].amount_on_sale可作免费库存快照参考，严格防超卖再考虑购包。