ログイン無料トライアルを開始
easyCoexistence 公式 API

TikTok エラー 40104:アクセストークンが空です

TikTok エラー 40104 は、アクセストークンを付けずにリクエストが届いたことを意味します。/business/video/list/ や /business/comment/list/ などの Accounts API エンドポイントは、TikTok アカウントのトークンを Access-Token という名前のヘッダーで受け取ります。有効なトークンをそのヘッダーに追加し、/tt_user/oauth2/token/ で取得したもの、またはリフレッシュトークンで更新したものを使って、リクエストを再送してください。

easyCoexistence は、Claude、ChatGPT、またはご自身のコードが行うすべての呼び出しに、TikTok アカウントの現在のトークンを Access-Token ヘッダーで追加します。

40104

アクセストークンが空のときに TikTok が返すリターンコードです。解決するには有効なトークンを送ります。

Access-Token

Accounts API のエンドポイントで、TikTok アカウントのトークンを運ぶ必須のヘッダーです。

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 で送ると、TikTok がトークンの種類を Bearer と返していても Access-Token は空のままになります。
  • トークンを保持している変数が空です。たとえば、エラーを確認せずに失敗した更新の後などです。
  • トークンがヘッダーではなく、ボディやクエリ文字列で送られています。
  • /tt_user/oauth2/token/ および /tt_user/oauth2/refresh_token/ 用に作ったヘルパーを流用しています。これらのエンドポイントは Access-Token ヘッダーを受け取らないため、ヘルパーは何も送りません。

どのように直しますか?

business_id と一緒に、トークンを Access-Token で送ります。現在のトークンが無い場合は取得します。リフレッシュトークンが有効なら /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 で送るとトークンが空のままになり、TikTok がトークンの種類を Bearer と返していても、呼び出しは 40104 を返します。

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 はそのアカウントの代わりに動作する認可を運びます。すべての呼び出しには両方が必要です。

続きを読む

最初のチャンネルを 2 分で接続しましょう。

プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。

  • 3 日間無料
  • いつでも解約可能
  • 公式 API のみ使用
  • 24/7 監視

確認日