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

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 请求头。

40104

TikTok 在访问令牌为空时返回的错误代码;解决方法是发送有效的访问令牌。

Access-Token

Accounts API 端点中承载 TikTok 账户访问令牌的必需请求头。

business_id

参数 business_id 用于指定每次调用中的 TikTok 账户,其值设为随访问令牌一同返回的 open_id。

Bearer

TikTok 账户访问令牌的 token_type,仍需在 Access-Token 中发送。

错误 40104 是什么意思?

TikTok 收到的调用中没有包含访问令牌。返回代码附录将 40104 列为访问令牌为空,其修复方法与其他令牌错误相同:使用有效的访问令牌后重试。请求已到达 TikTok,但其中没有任何内容说明它以哪一项授权执行,因此 TikTok 将该调用视为未成功。

访问令牌应放在哪里?

放在名为 Access-Token 的请求头中。从发布到评论和洞察的 Accounts API 参考文档均将 Access-Token 列为必需请求头,其值为 TikTok 账户授权的访问令牌。账户本身则通过 business_id 单独指定,其值设为随访问令牌一同返回的 open_id。

An Accounts API call with its token
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,并得到相同的代码。
使用 EasyCoexistence 完成这些操作

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

验证时间