用途:负责 TikTok 卖家账号的 OAuth 授权、已授权店铺列表、令牌查询与刷新,是通过开发者代理调用 TikTok 开放接口(商品、订单、履约、财务等)的前置依赖。
主要能力与授权类型:按 appType 区分三类授权。TikTok Shop 小店授权 appType=erp(默认);TikTok 视频号(带货内容)授权 appType=creator,授权时及后续查询、刷新令牌均须保持 appType=creator;联盟授权 appType=affiliate。店铺以 openId + appType 标记,同一店铺在不同 appType 下授权相互独立。region 支持 global(默认)与 us(美国站)。
使用方式:经 LinkFox 网关调用四个接口——/tiktokShop/authorizeUrl 生成授权链接(有效期约 1 小时,须每次重新获取),/tiktokShop/authorizedStores 列出已授权店铺,/tiktokShop/storeTokens 按 openId + appType 查询已入库令牌,/tiktokShop/refreshToken 刷新 access_token。对应脚本为 scripts/authorize_url.py、authorized_stores.py、store_tokens.py、refresh_token.py;令牌用于开发者代理 /tiktokShop/developerProxy,业务调用不属本技能范围。
流程:生成授权 URL 交由用户在浏览器完成授权,紫鸟回调并推送 Token,系统按 state 落库 access_token / refresh_token。accessToken 过期用 refreshToken 续签,refreshToken 过期须重新授权。
限制:查询与刷新时 appType 必须与授权时一致;authorizeUrl 约 1 小时失效;用户只能管理自己授权的店铺;回调 URL 与调用 IP 须在紫鸟处加白名单;展示令牌时应做掩码,不明文显示完整令牌。详细参数、响应结构与错误码见 references/api.md;资料未提供具体收费与价格信息。