登录开始免费试用
easyCoexistence 官方 API

TikTok 错误 40103:刷新令牌已过期

TikTok 错误 40103 表示刷新令牌已过期,无法再为该账户续期访问令牌。Accounts API 的刷新令牌有效期为一年。TikTok 给出的修复方法是重新授权:账户所有者重新走一遍应用的授权流程,即可获得新的访问令牌和新的刷新令牌,用来替换原有的一对令牌。

easyCoexistence 会保存每次 TikTok 续期返回的刷新令牌及其到期时间,并自动续期 24 小时有效的访问令牌,无论是为 Claude、ChatGPT 还是您自己的代码服务。

40103

TikTok 对刷新令牌已过期的返回码;修复方法是让用户重新授权应用。

1 year

Accounts API 刷新令牌的有效期。

31,536,000

在 TikTok 新签发令牌的示例中,refresh_token_expires_in 的值以秒计,恰好是一年。

10 minutes

重新授权时获得的授权码的有效期,且只能使用一次。

错误 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 参考文档要求保留它,用于下一次续期。
使用 EasyCoexistence 完成这些操作

若 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 监控

验证时间