TikTok 错误 40104:访问令牌为空
TikTok 错误 40104 表示请求在未携带访问令牌的情况下到达。/business/video/list/ 和 /business/comment/list/ 等 Accounts API 端点需要在名为 Access-Token 的请求头中携带 TikTok 账户的访问令牌。请添加该请求头,并填入有效的访问令牌(可从 /tt_user/oauth2/token/ 获取,或使用刷新令牌更新),然后重新发送请求。
easyCoexistence 会在为 Claude、ChatGPT 或您自己的代码所做的每次调用中,将 TikTok 账户当前的访问令牌放入 Access-Token 请求头。
TikTok 在访问令牌为空时返回的错误代码;解决方法是发送有效的访问令牌。
Accounts API 端点中承载 TikTok 账户访问令牌的必需请求头。
参数 business_id 用于指定每次调用中的 TikTok 账户,其值设为随访问令牌一同返回的 open_id。
TikTok 账户访问令牌的 token_type,仍需在 Access-Token 中发送。
错误 40104 是什么意思?
TikTok 收到的调用中没有包含访问令牌。返回代码附录将 40104 列为访问令牌为空,其修复方法与其他令牌错误相同:使用有效的访问令牌后重试。请求已到达 TikTok,但其中没有任何内容说明它以哪一项授权执行,因此 TikTok 将该调用视为未成功。
访问令牌应放在哪里?
放在名为 Access-Token 的请求头中。从发布到评论和洞察的 Accounts API 参考文档均将 Access-Token 列为必需请求头,其值为 TikTok 账户授权的访问令牌。账户本身则通过 business_id 单独指定,其值设为随访问令牌一同返回的 open_id。
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/video/list/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>' \
--data-urlencode 'fields=["item_id","caption","video_views"]'请求头为什么会变空?
访问令牌在存储与发送请求之间的某个环节丢失。可以从以下几个地方排查:
- 请求头使用了其他名称。以 Authorization: Bearer 发送的令牌会使 Access-Token 为空,即使 TikTok 将令牌类型标注为 Bearer。
- 保存令牌的变量为空,例如续期失败而其错误未被检查。
- 令牌在请求体或查询字符串中传递,而不是放在请求头中。
- 为 /
tt_user/oauth2/token/ 和 /tt_user/oauth2/refresh_token/ 编写的辅助函数被复用;这些端点不接受 Access-Token 请求头,因此该函数不会发送它。
应如何修复?
将访问令牌放在 Access-Token 中,并与 business_id 一同发送。如果没有可用的当前访问令牌,请先获取:在刷新令牌有效期内,使用 /tt_user/oauth2/refresh_token/ 续期;若刷新令牌已失效,则请账户所有者重新授权应用。调试时,请记录请求头是否存在以及其值的长度,而不要记录令牌本身,因为 TikTok 提示持有令牌的任何人均可使用它。
常见错误
- 将 40104 误判为访问令牌已过期。令牌是缺失而非陈旧,因此在代码真正发送令牌之前,续期访问令牌并无任何作用。
- 续期访问令牌后未传递新令牌。续期会返回新的访问令牌,后续调用必须在 Access-Token 中发送该值。
- 未作任何改动便重试请求。若没有该请求头,每次尝试都会以相同方式到达 TikTok,并得到相同的代码。
若 TikTok 仍返回 40102、40104 或 40105,连接会立即被标记为需要重新连接,并向您发送一封电子邮件。每个连接每月 US$ 9 起,连接越多越便宜,最低降至 US$ 0.75,前 3 天免费试用。
常见问题
可以将 TikTok 访问令牌以 Authorization: Bearer 形式发送吗?
不可以。Accounts API 端点从 Access-Token 请求头中读取访问令牌,因此以 Authorization: Bearer 发送的令牌会使其为空,调用便返回 40104,尽管 TikTok 将令牌类型标注为 Bearer。
40104 与访问令牌过期是同一回事吗?
不是。40104 表示根本没有收到访问令牌;令牌过期会返回 40102,无效或错误的令牌则返回 40105。
TikTok 令牌端点需要 Access-Token 吗?
不需要。/tt_user/oauth2/token/ 和 /tt_user/oauth2/refresh_token/ 改为在请求体中通过 client_id 和 client_secret 识别应用。
business_id 能替代访问令牌吗?
不能。business_id 说明调用针对哪个 TikTok 账户,Access-Token 则携带代表该账户执行操作的授权。每次调用都需要两者。
继续阅读
两分钟连接您的第一个渠道。
无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。
- 免费试用 3 天
- 随时取消
- 仅使用官方 API
- 全天候 24/7 监控
验证时间