TikTok エラー 40102:アクセストークンの有効期限切れ
TikTok エラー 40102 は、リクエストに付けられたアクセストークンの期限が切れていることを示します。最新のトークンを使ってエンドポイントを呼び出す必要があります。Accounts API のアクセストークンは 1 日有効です。/tt_user/oauth2/refresh_token/ にリフレッシュトークンを送信してトークンを更新し、その後で呼び出しを繰り返してください。リフレッシュトークン自体は 1 年間有効で、期限が切れた後はアカウント所有者がアプリを再度認証する必要があります。
easyCoexistence は、期限切れの前に 24 時間有効な TikTok トークンをリフレッシュトークンで自動的に更新するため、Claude、ChatGPT、お客様自身のコードからの呼び出しは常に最新のトークンで送信されます。
TikTok がアクセストークンの期限切れを示すリターンコードです。エンドポイントは最新のトークンで呼び出す必要があります。
Accounts API で発行される TikTok アカウントのアクセストークンが有効な期間です。
TikTok の、新しく発行されたアクセストークンの例に含まれる expires_in の値(秒単位)です。
リフレッシュトークンが有効な期間です。期限が切れると、所有者はアプリを再度認証する必要があります。
エラー 40102 とはどういう意味ですか?
Access-Token ヘッダーのアクセストークンの有効期限が切れています。TikTok のリターンコード一覧では、40102 は期限切れのアクセストークンを示し、最新のトークンでエンドポイントを呼び出す必要があると記されています。修正するには、有効なアクセストークンを使って再試行します。
このコードはレスポンスの本文に返されます。API for Business への呼び出しのほとんどは HTTP 200 を返し、呼び出しが成功したかどうかは、ステータスではなくリターンコードで判断されます。
TikTok のアクセストークンは、どのくらい有効ですか?
API for Business では 1 日です。Accounts API は、アプリが /tt_user/oauth2/token/ で認可コードを交換すると TikTok アカウントのアクセストークンを発行します。レスポンスの expires_in には有効期間が示され、TikTok の例では 86,400 秒です。同じレスポンスには有効期間 1 年のリフレッシュトークンも含まれ、TikTok はアクセストークンの更新に使うためこれを保存するよう推奨しています。Content Posting API が使う TikTok for Developers のユーザーアクセストークンは、代わりに 2 時間有効です。
トークンはどのように更新しますか?
アプリの ID とシークレット、および grant_type に refresh_token を指定して、リフレッシュトークンを /tt_user/oauth2/refresh_token/ に送信します。レスポンスには新しいアクセストークンとリフレッシュトークンが含まれます。両方を保存し、以後は新しいアクセストークンを Access-Token ヘッダーに設定して、失敗した呼び出しを繰り返してください。1 日が終わる前に更新しておくと、期限切れのトークンで TikTok に呼び出しが届くことを防げます。
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/oauth2/refresh_token/' \
-H 'Content-Type: application/json' \
-d '{
"client_id": "<APP_ID>",
"client_secret": "<SECRET>",
"grant_type": "refresh_token",
"refresh_token": "<REFRESH_TOKEN>"
}'
# data: access_token, expires_in (86400), refresh_token, refresh_token_expires_inアカウント所有者に再認証を依頼するのはいつですか?
更新できなくなったときです。リフレッシュトークンの有効期間は 1 年で、TikTok のドキュメントによると、期限が切れたら開発者は認可フローを通じてアカウント所有者にアプリの再認可を依頼します。所有者はいつでも TikTok アプリの「設定とプライバシー」「セキュリティ」「アプリの権限を管理」から認可を取り消せます。その場合は、再度認可を行うことで復旧します。
よくある間違い
- 呼び出しが失敗してから更新するだけ。1 日しか有効でないトークンは毎日切れるため、前もって更新し、古いトークンで TikTok に呼び出しが届かないようにしてください。
- 更新レスポンスのリフレッシュトークンを無視すること。TikTok のリファレンスでは次回の更新のために保存するよう記されているため、更新のたびに返される新しいものを保存してください。
- HTTP ステータスだけを確認すること。TikTok は通常 HTTP 200 を返し、40102 は code フィールドに入るため、ステータスだけで確認すると失敗が成功と判断されてしまいます。
- トークンのコピーを複数の場所に保存すること。一方のコピーを更新しても、他のコピーは 1 日が終わって 40102 で失敗します。
TikTok が 40102、40104、40105 のトークンを拒否した場合でも、接続はすぐに再接続が必要な状態としてマークされ、メールが届きます。お客様自身のコードは、コピーを保持する代わりに get_social_credentials から現在のトークンを取得できます。接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料トライアルです。
よくある質問
expires_in とは TikTok のトークンレスポンスで何を意味しますか?
アクセストークンが期限切れになるまでの秒数です。TikTok の新しい Accounts API トークンの例では 86,400 秒、つまり 1 日です。レスポンスの時刻にこの値を加えると、40102 が出る前に更新すべき時刻がわかります。
期限切れの TikTok アクセストークンは更新できますか?
リフレッシュトークンが有効であれば更新できます。/tt_user/oauth2/refresh_token/ に送信すると、TikTok から新しいアクセストークンとリフレッシュトークンが返されます。
エラー 40102 はアカウントの再接続が必要という意味ですか?
それだけでは必要ありません。有効なリフレッシュトークンがあれば、所有者の操作なしでアクセスを更新できます。再認可が必要になるのは、リフレッシュトークンが期限切れになったか、所有者がアクセスを取り消したときだけです。
HTTP 200 のレスポンスにエラー 40102 が含まれるのはなぜですか?
TikTok のリターンコードは HTTP ステータスより優先されます。呼び出しは、ステータス行の内容にかかわらず、コードが 0 の場合にのみ成功です。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日