TikTok 错误 40103:刷新令牌已过期
TikTok 错误 40103 表示刷新令牌已过期,无法再为该账户续期访问令牌。Accounts API 的刷新令牌有效期为一年。TikTok 给出的修复方法是重新授权:账户所有者重新走一遍应用的授权流程,即可获得新的访问令牌和新的刷新令牌,用来替换原有的一对令牌。
easyCoexistence 会保存每次 TikTok 续期返回的刷新令牌及其到期时间,并自动续期 24 小时有效的访问令牌,无论是为 Claude、ChatGPT 还是您自己的代码服务。
TikTok 对刷新令牌已过期的返回码;修复方法是让用户重新授权应用。
Accounts API 刷新令牌的有效期。
在 TikTok 新签发令牌的示例中,refresh_token_expires_in 的值以秒计,恰好是一年。
重新授权时获得的授权码的有效期,且只能使用一次。
错误 40103 是什么意思?
用于续期访问令牌的刷新令牌已超过有效期。TikTok 的返回码附录将 40103 列为刷新令牌已过期。修复方法是使用有效的刷新令牌;要获得有效的刷新令牌,需通过用户授权流程请用户重新授权应用。在此之前访问令牌无法续期,当前访问令牌到当天结束时失效,调用随之停止。
刷新令牌的有效期是多久?
一年。/tt_user/oauth2/token/ 的响应包含 refresh_token_expires_in,即刷新令牌到期前剩余的秒数:TikTok 示例中为 31,536,000,恰好一年。续期响应也带有同一字段,TikTok 的续期示例显示为 28,484,364 秒,不足一年,因此应以每次响应中的数值为准,不要假设每次续期都重新开始一年。
如何修复?
请账户所有者重新授权应用。将 TikTok 账户持有人授权 URL 发给对方;对方批准后,TikTok 会携带新的 auth_code 重定向到应用的重定向 URL,该授权码有效期为 10 分钟,且只能使用一次。用它在 /tt_user/oauth2/token/ 换取新的访问令牌和刷新令牌,并替换已保存的那一对。如果所有者此前已批准过相同的权限,TikTok 默认会跳过审核页面,直接将其带回应用。
40103 与 40107、40131 有何区别?
附录中有三个代码对应续期失败,它们指向不同的检查项:
- 40103:刷新令牌已过期。只有重新授权才能替换它。
- 40107:刷新令牌无效或不正确,例如误用于续期 Marketing API 令牌的刷新令牌,而该令牌永不过期。
- 40131:在 /
tt_user/oauth2/token/ 或 /tt_user/oauth2/refresh_token/ 处的认证错误,原因可能是应用 ID 或密钥错误、授权码已过期,或刷新令牌无效或已过期。
常见错误
- 等到出现 40103 才规划下一次授权。refresh_token_expires_in 会提前给出到期日期,因此可以在续期停止前请所有者重新授权。
- 以为每次续期都会重新计算一年。TikTok 的续期示例在 refresh_token_expires_in 中返回的时间不足一年,因此要读取每个响应中的数值。
- 丢弃续期时返回的刷新令牌。TikTok 参考文档要求保留它,用于下一次续期。
若 TikTok 拒绝续期,工具会返回 TikTok 的错误代码和消息;在控制台重新连接该账户,即可签发新的一对令牌。每个连接每月 US$ 9 起,连接越多越便宜,最低降至 US$ 0.75,前 3 天免费试用。
常见问题
Content Posting API 的刷新令牌也能用一年吗?
不能。TikTok for Developers 的刷新令牌(用于 Content Posting API)有效期为 180 天;一年的有效期属于 API for Business 的刷新令牌,其剩余秒数显示在 refresh_token_expires_in 中。
过期的 TikTok 刷新令牌还能续期吗?
不能。TikTok 对 40103 的修复方法是账户所有者重新授权,由此签发新的访问令牌和新的刷新令牌。
账户所有者还会看到 TikTok 的权限页面吗?
默认不会。如果他们此前已批准过相同的权限,TikTok 会跳过审核页面,并携带新的授权码重定向回应用。
刷新令牌过期后,调用会怎样?
调用会继续有效,直到当前访问令牌到当天结束时失效。之后调用会因 40102 失败,因为该令牌已无法续期。
继续阅读
两分钟连接您的第一个渠道。
无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。
- 免费试用 3 天
- 随时取消
- 仅使用官方 API
- 全天候 24/7 监控
验证时间