SuperAPI AI 工具集

linkfox-amazon-store-auth

通用与其它

查看项目

更新于 10-16 06:23

技能介绍

用途:管理亚马逊卖家店铺的 OAuth 授权与令牌生命周期,是拉取报告、查询库存、同步订单等下游操作的前置依赖。下游业务通过 developerProxy 传入 sellerId+region 即可,无需获取原始 token。

主要能力:生成授权链接(/spApi/authorizeUrl,需非空 sellerName)、查询已授权店铺(/spApi/authorizedStores)、刷新令牌(/spApi/refreshToken)、查询授权/令牌状态(/spApi/storeTokens)、本地取消授权(/spApi/cancelAuthorization)。支持区域 NA(北美)、EU(欧洲)、FE(远东),默认 NA。accessToken 通常 1 小时过期,refreshToken 用于续签。

使用方式:API 端点 POST /spApi/{authorizeUrl|storeTokens|authorizedStores|refreshToken|cancelAuthorization};也可用 Python 脚本 python scripts/<脚本名>.py '<JSON 参数>' [--inline]。脚本默认将完整响应写入 <cwd>/linkfox/<日期>/<session>/data/ 下,响应超过 8 KB 时 stdout 只输出摘要,可用 --inline 强制全量打印。

适用场景:新店铺授权、查看已授权店铺、刷新过期令牌、查询授权状态、取消/解绑授权,以及为下游业务做选店准备(列出店铺→用户选择→确认授权→交付 sellerId+region)。

限制:sellerName 必填;每次授权与具体区域绑定,不同区域需分别授权;用户只能管理自己授权的店铺;回调 URL 需在授权方加白名单;解绑覆盖整个区域,需用户明确同意。同一店铺连续触发 Amazon SP-API 的 400/403/404/429 时网关会返回 450/453/454/459 并短暂冷却,此时应停止自动重试,按提示修正参数或授权后谨慎重试。本技能不消耗算力。具体请求参数、响应结构与错误码见 references/api.md。