TikTok API 连接为何失效,以及如何保持连接畅通
当 TikTok API for Business 连接的 24 小时访问令牌未续期、一年期刷新令牌到期、账户所有者移除应用的访问权限,或发送的令牌缺失或有误时,连接便会失效。TikTok 以 40102、40103、40104 和 40105 返回这些令牌问题。提前续期、按计划检查每个账户,并在一年到期前请账户所有者重新授权,可使连接保持畅通。
easyCoexistence 会自行保持每个 TikTok 连接畅通:提前续期 24 小时令牌,约每 6 小时检查一次账户;当 TikTok 拒绝令牌时,它会将渠道标记为需要重新连接,并向您发送电子邮件,适用于 Claude、ChatGPT 或您自己的平台。
TikTok API for Business 中账户访问令牌的有效期;/tt_user/oauth2/refresh_token/ 用于续期。
刷新令牌的有效期;到期后,账户所有者须重新授权应用。
TikTok 处理帖子时,若所有者移除应用的访问权限,即出现此失败原因;TikTok 指示不要重试。
账户所有者的授权到期或被撤销后,TikTok 停止为该账户发送的事件。
TikTok for Developers 的 authorization.removed 事件触发原因:用户断开连接、账户被删除、年龄变更、账户被封禁,或开发者撤销授权。
easyCoexistence 检查每个已连接 TikTok 账户的频率;它会自行续期 24 小时令牌,并在需要重新连接时向您发送电子邮件。
TikTok API 连接为何会失效?
原因主要有几种,多数与账户的令牌或所有者的同意有关。有些会直接终止连接,有些则使连接只能部分运行,部分调用被拒绝,其余仍能正常响应:
每种原因返回哪个错误,如何修复?
TikTok 的 code 字段标明了大部分错误,并且是在 HTTP 200 响应中返回,而非错误状态码;发布状态另外附有自己的失败原因。40100 列在表中,是因为被限流的调用可能看起来像连接已断开。以下是每种情况的含义及修复方法:
| What it means | The fix | |
|---|---|---|
| 40102 | The access token is past its 24 hours | Renew with the refresh token, store both new tokens, repeat the call |
| 40103 | The refresh token has expired | A new authorization by the owner; nothing renews it |
| 40104 | The request carried no access token | A bug in the request: send the Access-Token header |
| 40105 | The access token is invalid or incorrect | Check what was sent, renew, then ask the owner to authorize again |
| 40107 | The refresh token is invalid or incorrect | Send the refresh token from the latest response, or a new authorization |
| 40131 | Authentication failed at a token endpoint | Check the app ID and secret, then the code or the refresh token |
| 40001 | A permission or scope is missing | Add it to the app, then have the owner authorize again |
| auth_removed | Access was removed while a post was processing | No retry; publish again after a new authorization |
| 40100 | Throttled, not disconnected | Pause 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和事件目的地。
设置方法
- 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.
- 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.
- Check each accountMake one light call per account on a schedule and record any 40102, 40103, 40104 or 40105 against that account.
- 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.
- 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,之后同一令牌即可继续使用。
每个连接每月 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 监控
验证时间