Shopee 店铺授权与管理

Shopee Open Platform 的 OAuth 授权、已授权店铺列表、授权状态读取。下游业务的前置依赖（经 /shopee/developerProxy 调用开放接口）。

Shopee ERP 与 广告（AD） 使用不同应用与 Token，必须按能力分开授权。

Core Concepts

• 双应用：appType=erp（商品/订单/物流等，默认）与 appType=ad（站内广告）彼此独立；同店可同时有两条授权
• 授权流程：生成 URL → 用户浏览器授权 → Shopee 推送 Token → 系统按 state 落库
• 店铺标识：shopId 与 merchantId 二选一即可定位；判断是否已授权须同时匹配 shopId/merchantId + appType
• shopName 建议填写：调 authorize_url.py 前建议问用户要一个便于识别的店铺名（API 非必填）
• 授权 URL 1 小时有效：每次授权重新调用 authorize_url.py，不要缓存旧地址
• 下游选店：业务 skill 经 developerProxy 只传 shopId/merchantId + path；勿传 accessToken，也勿在 proxy 里传 appType（服务端按 path 自动路由：api/v2/ads/** → AD，其它 api/v2/** → ERP）
• accessToken 约 4 小时有效（expireIn 通常 14400）；过期需按对应 appType 重新授权

Shopee authorization routing