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

TikTok 错误 40102:访问令牌已过期

TikTok 错误 40102 表示随请求发送的访问令牌已过期,需要使用最新的令牌调用该端点。Accounts API 的访问令牌有效期为 1 天。请将刷新令牌发送至 /tt_user/oauth2/refresh_token/ 以续期,然后重新执行该调用。刷新令牌本身有效期为 1 年,到期后账户所有者需要重新授权该应用。

EasyCoexistence 会在令牌到期前,自动用刷新令牌续期这个 24 小时的 TikTok 令牌,使 Claude、ChatGPT 或您自己的代码发出的调用始终带有当前令牌。

40102

TikTok 针对已过期访问令牌的返回代码;必须使用最新的令牌调用该端点。

1 day

Accounts API 签发的 TikTok 账户访问令牌的有效期。

86,400

TikTok 新签发访问令牌示例中的 expires_in 值,单位为秒。

1 year

刷新令牌的有效期;过期后,账户所有者必须重新授权该应用。

错误 40102 是什么意思?

“Access-Token” 请求头中的访问令牌已超过有效期。TikTok 返回代码附录将 40102 列为访问令牌已过期,并说明需要使用最新的令牌调用该端点。解决方法是使用有效的访问令牌后重试。

该代码包含在响应主体中。TikTok API for Business 的大多数调用返回 HTTP 200,调用是否成功取决于返回代码,而非状态码。

TikTok 访问令牌有效期多久?

在 TikTok API for Business 上为 1 天。当应用在 /tt_user/oauth2/token/ 用授权码交换令牌时,Accounts API 签发 TikTok 账户访问令牌,响应中的 expires_in 给出其有效期,TikTok 示例中为 86,400 秒。同一响应还包含一个有效期为 1 年的刷新令牌,TikTok 建议保留该令牌,用于续期访问令牌。TikTok for Developers 的用户访问令牌(由 Content Posting API 使用)有效期则为 2 小时。

如何续期?

将刷新令牌连同应用的 ID 和密钥发送至 /tt_user/oauth2/refresh_token/,并将 grant_type 设为 refresh_token。响应中包含新的访问令牌和刷新令牌:两者都需保存,此后在 “Access-Token” 请求头中发送新的访问令牌,然后重新执行失败的调用。在当天到期前续期,可避免请求因令牌过期而无法到达 TikTok。

Renew a TikTok account access token
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/oauth2/refresh_token/' \
  -H 'Content-Type: application/json' \
  -d '{
    "client_id": "<APP_ID>",
    "client_secret": "<SECRET>",
    "grant_type": "refresh_token",
    "refresh_token": "<REFRESH_TOKEN>"
  }'

# data: access_token, expires_in (86400), refresh_token, refresh_token_expires_in

何时需要账户所有者重新授权?

当无法再续期时。刷新令牌有效期为 1 年,TikTok 文档说明,过期后开发者需通过授权流程请账户所有者重新授权该应用。账户所有者也可随时在 TikTok 应用中撤销授权:进入“设置和隐私”、“安全”、“管理应用权限”,此后重新授权即可恢复。

常见错误

  • 只在调用失败后才续期。一天有效的令牌每天都会过期,因此应提前续期,避免请求带着旧令牌到达 TikTok。
  • 忽略续期响应中的刷新令牌。TikTok 参考文档要求保留它用于下一次续期,因此每次续期返回的刷新令牌都要保存。
  • 只检查 HTTP 状态。TikTok 通常返回 HTTP 200,并在 code 字段中给出 40102,仅检查状态会把失败误判为成功。
  • 在多处保存令牌副本。只更新其中一份,其他副本会在各自的当天有效期结束后因 40102 失败。
使用 EasyCoexistence 完成这些操作

若 TikTok 仍以 40102、40104 或 40105 拒绝令牌,该连接会立即被标记为需要重新连接,您也会收到一封邮件。您自己的代码可以通过 get_social_credentials 获取当前令牌,无需保存副本。每个连接每月 US$ 9 起,连接越多单价越低,最低降至 US$ 0.75,并享有前 3 天免费试用。

常见问题

TikTok 令牌响应中的 expires_in 是什么意思?

它是访问令牌过期前的秒数:在 TikTok 新 Accounts API 令牌示例中为 86,400,即 1 天。将其与响应时间相加,即可在出现 40102 之前知道何时续期。

过期的 TikTok 访问令牌可以续期吗?

可以,只要刷新令牌仍然有效。将其发送至 /tt_user/oauth2/refresh_token/,TikTok 会返回新的访问令牌和一个刷新令牌。

错误 40102 是否意味着必须重新连接账户?

并非如此。有效的刷新令牌无需账户所有者即可续期访问;只有刷新令牌过期或所有者撤销了访问权限时,才需要重新授权。

为什么 HTTP 200 的响应中会包含错误 40102?

TikTok 的返回代码优先于 HTTP 状态。只有返回代码为 0 的调用才算成功,无论状态行显示什么。

继续阅读

两分钟连接您的第一个渠道。

无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。

  • 免费试用 3 天
  • 随时取消
  • 仅使用官方 API
  • 全天候 24/7 监控

验证时间