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

TikTok API 连接为何失效,以及如何保持连接畅通

当 TikTok API for Business 连接的 24 小时访问令牌未续期、一年期刷新令牌到期、账户所有者移除应用的访问权限,或发送的令牌缺失或有误时,连接便会失效。TikTok 以 40102、40103、40104 和 40105 返回这些令牌问题。提前续期、按计划检查每个账户,并在一年到期前请账户所有者重新授权,可使连接保持畅通。

easyCoexistence 会自行保持每个 TikTok 连接畅通:提前续期 24 小时令牌,约每 6 小时检查一次账户;当 TikTok 拒绝令牌时,它会将渠道标记为需要重新连接,并向您发送电子邮件,适用于 Claude、ChatGPT 或您自己的平台。

24 hours

TikTok API for Business 中账户访问令牌的有效期;/tt_user/oauth2/refresh_token/ 用于续期。

1 year

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

auth_removed

TikTok 处理帖子时,若所有者移除应用的访问权限,即出现此失败原因;TikTok 指示不要重试。

comment.update

账户所有者的授权到期或被撤销后,TikTok 停止为该账户发送的事件。

5 reasons

TikTok for Developers 的 authorization.removed 事件触发原因:用户断开连接、账户被删除、年龄变更、账户被封禁,或开发者撤销授权。

6 hours

easyCoexistence 检查每个已连接 TikTok 账户的频率;它会自行续期 24 小时令牌,并在需要重新连接时向您发送电子邮件。

TikTok API 连接为何会失效?

原因主要有几种,多数与账户的令牌或所有者的同意有关。有些会直接终止连接,有些则使连接只能部分运行,部分调用被拒绝,其余仍能正常响应:

Access token expired24 hours passed without a renewal, and calls return 40102
Refresh token expiredIts year ended: renewal returns 40103 until the owner signs in again
Access removedThe owner chose Remove access in TikTok, or the app revoked the token
Wrong tokenMissing from the request (40104), or invalid or incorrect (40105)
Missing permissionA call outside the granted permissions returns 40001
Account level changedData tied to Advanced Access or verification is no longer available
App access revokedTikTok can revoke an app's Accounts API access for misuse, without notice

每种原因返回哪个错误,如何修复?

TikTok 的 code 字段标明了大部分错误,并且是在 HTTP 200 响应中返回,而非错误状态码;发布状态另外附有自己的失败原因。40100 列在表中,是因为被限流的调用可能看起来像连接已断开。以下是每种情况的含义及修复方法:

What it meansThe fix
40102The access token is past its 24 hoursRenew with the refresh token, store both new tokens, repeat the call
40103The refresh token has expiredA new authorization by the owner; nothing renews it
40104The request carried no access tokenA bug in the request: send the Access-Token header
40105The access token is invalid or incorrectCheck what was sent, renew, then ask the owner to authorize again
40107The refresh token is invalid or incorrectSend the refresh token from the latest response, or a new authorization
40131Authentication failed at a token endpointCheck the app ID and secret, then the code or the refresh token
40001A permission or scope is missingAdd it to the app, then have the owner authorize again
auth_removedAccess was removed while a post was processingNo retry; publish again after a new authorization
40100Throttled, not disconnectedPause the endpoint 5 minutes; the token still works

令牌有效期多久,何时续期?

在 API for Business 上,访问令牌有效 24 小时,每个令牌响应中的 expires_in 给出剩余秒数;刷新令牌有效一年,其倒计时在 refresh_token_expires_in 中显示。请在当天结束前提前续期,按计划进行,而非在调用失败之后才续期,并保存每次续期返回的刷新令牌,因为 TikTok 对该字段的说明是要保留它。请把 refresh_token_expires_in 视为截止期限:在 TikTok 的续期示例中,它是倒计时,而不是开始新的一年。

所有者移除应用的访问权限时会发生什么?

应用将失去所有者授予的 Accounts API 权限,因此使用该令牌的调用将停止工作;TikTok 没有记录任何 API for Business 事件会通知此事。所有者可随时在 TikTok 应用中操作:设置和隐私,安全,管理应用权限,移除访问权限。其迹象会在别处显示:TikTok 正在处理的帖子会以 auth_removed 失败,TikTok 指示不要重试;该账户的 comment.update 事件也会停止到达。

更改账户类型会对连接产生什么影响?

TikTok 文档中未将此与任何令牌错误相关联;变化的是 API 返回的内容。unique_video_views、daily_new_followers 和 audience_activity 等数据需要 Advanced Access 或认证商业账户,Mentions 和 Business Messaging API 同样如此;私人账户的 privacy_level_options 不包含 PUBLIC_TO_EVERYONE。自 2026 年 10 月 16 日起,is_business_account 仅对认证商业账户返回 true,has_advanced_access 则反映是否具有 Advanced Access,因此同时读取 user.account.type 下的这两项,可在调用出错之前发现变化。

如何在客户发现之前发现失效的连接?

通过无论是否有人发帖都会运行的检查:

  • 按计划对每个账户进行一次轻量调用,例如带 username 字段的 /business/get/,令牌失效后会返回令牌错误。
  • /tt_user/token_info/get/ 无需权限,返回令牌的 scope,用于确认授权仍涵盖您的功能所调用的内容。
  • 每次响应到达时,将 refresh_token_expires_in 换算为日期,并在到期前数周提醒所有者。
  • 对于通常会收到评论的账户,若长时间没有 comment.update 事件,应予以留意,因为 TikTok 会在授权到期或被撤销后停止这些事件。
  • 按账户统计 40102、40103、40104 和 40105,以便在大量账户中突出显示出现故障的账户。

如何重新连接账户?

对同一账户再次运行授权。分享 TikTok 账户持有人授权 URL,并附带将返回与该账户关联的 state 值;若希望所有者再次看到权限页面,则加上 disable_auto_auth=1。在 10 分钟内于 /tt_user/oauth2/token/ 交换新的 auth_code,然后替换两个已保存的令牌。open_id 是 TikTok 为该账户提供的应用专属 ID,因此应按它将新令牌匹配到已保存的记录,而不是新建一条记录。

Content Posting API 的连接也以同样方式过期吗?

不是。TikTok for Developers(提供 Content Posting 和 Display API)于 2026 年 11 月 2 日更新了令牌页面:用户访问令牌在 2 小时内过期,刷新令牌自首次签发起有效 180 天。其刷新令牌会轮换,因此每次成功刷新都会返回新的刷新令牌,并立即使所发送的旧令牌失效;若服务器继续使用已被替换的令牌,之后的刷新将失败,用户必须重新授权。无效的刷新令牌会返回 invalid_grant,无效的访问令牌会返回 access_token_invalid 和 HTTP 401,其 authorization.removed webhook 会说明用户离开的原因。

easyCoexistence 如何保持 TikTok 连接畅通?

它会自行续期和检查,并在只有所有者能够解决问题时通知您:

  • 续期:当剩余不足 15 分钟时在调用前续期;在检查期间,当剩余不足 8 小时时续期,每次都保存新的刷新令牌及其到期时间。
  • 每个账户一次只进行一次续期,因此同时到达的调用共享同一次续期。
  • 检查:约每 6 小时对该账户的 username 进行一次 /business/get/ 调用。
  • 令牌被拒绝(40102、40104 或 40105):该渠道显示需要重新连接,所有者收到一封电子邮件,平台会收到 channel.disconnected,并将 TikTok 的消息作为 disconnected_reason。
  • 在此期间,工具会回复该账户需要重新连接,计划发布的帖子会以 reconnect 失败,而不会发送至 TikTok。
  • 重新连接:在渠道页面点击 Connect TikTok,或新建连接会话,重新登录后会保留相同的 account_id 和事件目的地。

设置方法

  1. Store both tokens with datesSave access_token, refresh_token, open_id and scope, and turn expires_in and refresh_token_expires_in into dates as each response arrives.
  2. Renew ahead of the dayCall /tt_user/oauth2/refresh_token/ well before the 24 hours end, one renewal per account at a time, and keep the refresh token it returns.
  3. Check each accountMake one light call per account on a schedule and record any 40102, 40103, 40104 or 40105 against that account.
  4. Ask before the year endsSend the owner the authorization URL before refresh_token_expires_in runs out, and replace both tokens when the new code arrives.
  5. Reconnect on a token errorWhen renewal fails or the token is refused, stop calling for that account and send its owner the authorization URL.

常见错误

  • 将评论 Webhook 的沉默误判为账户没有动静。账户授权结束后 TikTok 会停止发送 comment.update,因此应主动检查账户,而不是等待事件。
  • 重新连接时新建记录。应按 open_id(TikTok 为该账户提供的应用专属 ID)匹配新令牌,并原地更新已保存的记录,保留其历史和设置。
  • 使用相同的刷新令牌重试 40103 或 40107。两者都不会因重试而清除:前者需要新的授权,后者需要最新响应中的刷新令牌或新的授权。
  • 将 40100 误判为连接已断开。它是限流的调用;暂停该端点 5 分钟,或在达到每日限额后暂停至 UTC 00:00,之后同一令牌即可继续使用。
使用 EasyCoexistence 完成这些操作

每个连接每月 US$ 9 起,连接越多越便宜,最低降至 US$ 0.75,并提供 3 天免费试用。

常见问题

没有所有者,TikTok API 连接能永久有效吗?

不能。续期最多只能借助刷新令牌的一年有效期维持连接;此后,TikTok 记录的做法是由账户所有者重新授权。

为何多个账户的 TikTok 连接同时失败?

应先检查应用,再检查账户:40113 表示应用被封锁,或其 ID 与密钥不匹配;TikTok 可能因滥用而撤销应用的 Accounts API 访问权限。

新功能是否需要重新连接 TikTok 账户?

若该功能需要所有者从未授予的权限范围,则需要。令牌保留授权时批准的权限范围,因此所有者需要再次授权应用才能添加。

账户需要重新连接时,计划中的 TikTok 帖子会怎样?

在 easyCoexistence 上,这些帖子会在预定时间以 reconnect 失败,而不会发送至 TikTok,所有者会收到电子邮件;账户重新连接后,点击 Retry 即可发送。

继续阅读

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

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

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

验证时间