Mock 演示
只生成本地演示店铺和数据，不代表真实 TikTok Shop 已经授权。
TikTok Shop Open API
TikTok Shop OAuth 授权步骤
商家通过 TikTok Shop 官方授权页，主动允许 Growth Copilot 读取商品、订单、库存和店铺信息。 授权完成后，系统才能同步真实运营数据。
这不是普通 TikTok 账号授权
这是 TikTok Shop 商家为开发者应用授予业务 API 权限的 OAuth 流程。Growth Copilot 不会要求客户向本系统提供 TikTok Shop 密码，登录和权限确认只在 TikTok Shop 官方页面完成。
商家授权流程
通常 2–5 分钟完成，请使用拥有店铺管理权限的 Seller Center 账号。
- 1
准备 Seller Center 管理员账号
确认账号拥有目标店铺的管理权限，并核对店铺所属区域。
- 2
点击授权店铺
在 Growth Copilot 点击 Connect TikTok Shop / 授权店铺。
- 3
进入 TikTok Shop 官方页面
只在官方 Seller Center 页面登录，不向本系统提供密码。
- 4
选择店铺并核对权限
选择目标店铺，核对商品、订单、库存和店铺信息权限。
- 5
确认并返回系统
确认授权后，等待 TikTok Shop 官方页面跳回 Growth Copilot。
- 6
检查连接并首次同步
确认店铺名称、地区和 Connected 状态，再点击 Sync Now。
授权成功判断：页面显示店铺名称、地区、Connected 状态和最后同步时间，并且可以执行 Sync Now。
识别当前连接状态
先确认当前模式，再决定是体验演示、同步数据还是重新授权。
真实 OAuth
客户在 TikTok Shop 官方页面确认后，系统获得约定范围内的 Open API 权限。
重新授权
token 过期、授权撤销或刷新失败时重新连接，历史业务数据不会因此删除。
常见问题与处理
授权页看不到目标店铺
检查当前 Seller Center 账号是否拥有店铺管理员权限，并确认登录区域与店铺区域一致。
提示 App Key 或 Redirect URI 未配置
这是系统管理员配置问题。请联系平台管理员完成 TikTok Shop 开发者应用和回调地址配置。
提示 state 过期或授权失败
返回系统重新点击授权店铺。授权链接有效期较短，请勿复用之前打开的旧链接。
在官方页面取消了授权
系统不会创建店铺连接，也不会读取数据；准备好后可以重新发起授权。
无法继续连接第二个店铺
Free 和 Pro 套餐最多连接一个店铺。可断开旧连接，或升级到支持多店铺的 Team / Agency。
连接显示 Expired 或 Revoked
历史商品和订单数据仍会保留。点击 Reconnect，重新完成一次官方 OAuth 授权即可。
开发者配置（系统管理员）
上线前配置
- 1. 在 TikTok Shop Partner Center 创建并通过开发者应用审核。
- 2. 配置 App Key、App Secret 和 Redirect URI 后端环境变量。
- 3. Redirect URI 必须与开发者后台登记值完全一致，生产环境使用 HTTPS。
- 4. 将 TIKTOK_SHOP_MOCK_MODE 设置为 false，再测试真实 OAuth。
系统只读取授权范围内的运营数据。商品发布、达人邀约、广告暂停等高风险动作继续保留人工确认；断开授权不会删除历史业务数据。