🏢《淘宝开放平台个人开发者 vs 企业开发者权限与接口差异对比》（附Python源码）

一、个人开发者 vs 企业开发者——核心差异表

✅ 结论：做商品比价、淘宝客选品 → 个人号够用；

做店铺商品同步、订单自动回写、发货推单 → 必须企业开发者 + 卖家AccessToken。

二、Python：通用TOP API Client（个人/企业通用）

# top_universal_client.py
"""
淘宝开放平台(TOP) 通用API Client
兼容个人开发者(无session) 和 企业开发者(传session)
网关: https://gw.api.taobao.com/router/rest  (生产)
"""
import hashlib
import time
import requests
from typing import Dict, Optional

# 封装好API供应商demo url=https://console.open.onebound.cn/console/?i=Lex
class TopClient:
    GATEWAY = "https://gw.api.taobao.com/router/rest"

    def __init__(self, app_key: str, app_secret: str, sandbox: bool = False):
        self.app_key = app_key
        self.app_secret = app_secret
        if sandbox:
            self.gateway = "https://gw.api.tbsandbox.com/router/rest"
        else:
            self.gateway = self.GATEWAY

    # ─────────── TOP标准MD5签名 ───────────
    def _sign(self, params: Dict) -> str:
        filt = sorted((k, v) for k, v in params.items()
                      if v is not None and str(v).strip() != '' and k != 'sign')
        qs = ''.join(f"{k}{v}" for k, v in filt)
        raw = f"{self.app_secret}{qs}{self.app_secret}"
        return hashlib.md5(raw.encode()).hexdigest().upper()

    def call(self, method: str, biz: Dict,
             session: Optional[str] = None) -> Dict:
        """
        Args:
            method: TOP API名, 如 'taobao.item.get'
            biz:    业务参数字典
            session: 卖家AccessToken（订单/店铺私有数据需传）
        Returns:
            对应 method_response 部分 (dict)
        """
        api_params = {
            "method": method,
            "app_key": self.app_key,
            "timestamp": str(int(time.time() * 1000)),  # 毫秒!
            "format": "json",
            "v": "2.0",
            "sign_method": "md5"
        }
        if session:
            api_params["session"] = session

        # 合并业务参数
        api_params.update(biz)
        api_params["sign"] = self._sign(api_params)

        # TOP推荐POST(x-www-form-urlencoded)
        resp = requests.post(self.gateway, data=api_params, timeout=15)
        resp.raise_for_status()
        data = resp.json()

        if "error_response" in data:
            err = data["error_response"]
            raise Exception(
                f"TOP Err[{err.get('code')}]: {err.get('msg')} "
                f"sub:{err.get('sub_msg','')}"
            )

        # 返回根节点数据
        resp_key = method.replace(".", "_") + "_response"
        return data.get(resp_key, data)

    # ---- 快捷方法 ----

    def get_item(self, num_iid: str, fields: str = None,
                 session: str = None) -> Dict:
        """商品详情（个人号可不传session查公开字段）"""
        fields = fields or "num_iid,title,price,pic_url,skus,approve_status,num"
        return self.call(
            "taobao.item.get",
            biz={"num_iid": num_iid, "fields": fields},
            session=session
        ).get("item", {})

    def list_onsale_items(self, page_no=1, page_size=40,
                          session: str = None) -> Dict:
        """
        店铺在售商品列表（★企业开发者+卖家授权才可调，
        个人号调会报 403 no permission）
        """
        return self.call(
            "taobao.items.onsale.get",
            biz={
                "page_no": page_no,
                "page_size": min(page_size, 100),
                "fields": "num_iid,title,price,num,outer_id,approve_status"
            },
            session=session
        )

    def list_sold_orders(self, start_modified: str, end_modified: str,
                         session: str, page_no=1) -> Dict:
        """
        卖家订单列表（企业+授权）
        start/end格式: 'YYYY-MM-DD HH:MM:SS'
        """
        return self.call(
            "taobao.trades.sold.get",
            biz={
                "fields": "tid,status,payment,modified,buyer_nick,"
                          "receiver_name,receiver_mobile,orders",
                "start_modified": start_modified,
                "end_modified": end_modified,
                "page_no": page_no,
                "page_size": 40
            },
            session=session
        )
# 封装好API供应商demo url=https://console.open.onebound.cn/console/?i=Lex

# =========================================================
# 使用示例
# =========================================================
if __name__ == "__main__":
    client = TopClient(
        app_key="YOUR_APP_KEY",
        app_secret="YOUR_APP_SECRET",
        sandbox=False
    )

    try:
        # ✅ 个人/企业都可查公开商品信息
        item = client.get_item("654321098765")
        print("✅ 商品标题:", item.get("title"))
        print("   价格:", item.get("price"))

        # ⚠️ 下列两行在企业应用+卖家AccessToken下才可用
        # orders = client.list_sold_orders("2026-06-01 00:00:00",
        #                                  "2026-06-25 23:59:59",
        #                                  session="SELLER_ACCESS_TOKEN")
        # print("待处理订单数:", len(orders.get("trades",[])))

    except Exception as e:
        print("❌", e)

三、如何判断当前Key是个人还是企业+有无权限？

• 返回数据 → 企业应用 + 卖家已授权 ✅

• 403 no permission / invalid method → 个人应用或无权限 ❌（正常）

四、面试/方案一句话

淘宝开放平台个人号可做商品查询/淘宝客选品，但无店铺订单/物流/在售商品列表权限；企业实名应用获得卖家OAuth授权后可调 taobao.trades.sold.get / items.onsale.get / logistics.online.send完成ERP全链路对接，签名网关完全一致，区别仅在是否传 session(AccessToken)及接口权限审批状态。