SuperAPI AI 工具集

linkfox-shopee-store-auth

通用与其它

查看项目

更新于 10-15 23:59

技能介绍

用途:处理 Shopee Open Platform 的 OAuth 授权、已授权店铺列表与授权状态读取,作为下游业务调用的前置依赖(经 /shopee/developerProxy 调用开放接口)。

主要能力:ERP 与广告(AD)使用不同应用与 Token,必须按能力分开授权。appType=erp 用于商品、订单、物流等(默认),appType=ad 用于站内广告,彼此独立,同店可同时存在两条授权。授权流程为生成 URL、用户浏览器授权、Shopee 推送 Token、系统按 state 落库。可用脚本:authorize_url.py 生成授权 URL(可选 shopName/region/appType);authorized_stores.py 列出已授权店铺(含 appType);store_tokens.py 查指定应用授权/令牌状态(须传 appType)。

使用方式:API 端点为 POST /shopee/{authorizeUrl|storeTokens|authorizedStores};Python 脚本为 python scripts/<脚本名>.py '<JSON 参数>' [--inline]。授权时建议填写 shopName,region 支持 cn/global/br,appType 支持 erp/ad。授权 URL 1 小时有效,每次重新调用生成,不可缓存旧地址。下游选店经 developerProxy 只传 shopId/merchantId 与 path,勿传 accessToken 或 appType。检查授权须同时匹配店铺标识与 appType。

适用场景:新授权店铺、广告应用授权、同时需要 ERP 与广告、列已授权店铺、为下游准备选店信息。

限制:accessToken 约 4 小时有效,过期须按对应 appType 重新授权;历史空 app_type 视为 ERP,不是 AD;失败或空结果不得自动连续试探。本工具不消耗算力。未配置 API Key、401/402、算力余额不足等异常按 references/onboarding.md 处理。订单、商品、物流、广告业务等由对应专用 skill 处理。