TikTok エラー 40103:リフレッシュトークンの有効期限切れ
TikTok エラー 40103 は、リフレッシュトークンの有効期限が切れたことを示します。そのため、アカウントのアクセストークンを更新できなくなります。Accounts API のリフレッシュトークンの有効期間は 1 年です。TikTok が案内する対処法は再認可です。アカウント所有者がアプリの認可フローをもう一度完了すると、新しいアクセストークンとリフレッシュトークンが発行されます。それらを、古いペアの代わりに保存してください。
easyCoexistence は、TikTok の更新ごとにリフレッシュトークンとその有効期限を保存し、24 時間のアクセストークンを自動で更新します。
TikTok のリターンコードで、リフレッシュトークンの期限切れを示します。対処法は、ユーザーがアプリを再度認可することです。
Accounts API のリフレッシュトークンが有効な期間です。
refresh_token_expires_in の値は秒単位です。TikTok の新規発行トークンの例では、ちょうど 1 年(秒数)になります。
新しい認可で得られる認可コードの有効期間です。使用は 1 回限りです。
エラー 40103 とは何ですか?
アクセストークンを更新するために送信されたリフレッシュトークンが、有効期限を過ぎています。TikTok のリターンコード一覧では、40103 はリフレッシュトークンの期限切れとして記載されています。対処法は、有効なリフレッシュトークンを使うことです。それには、ユーザー認可ワークフローを通じてアプリを再認可してもらう必要があります。それまでアクセストークンは更新できず、現在のトークンの期限が切れると、呼び出しは動作しなくなります。
リフレッシュトークンの有効期間はどれくらいですか?
1 年です。/tt_user/oauth2/token/ のレスポンスには refresh_token_expires_in が含まれます。これは、リフレッシュトークンが期限切れになるまでの残り秒数です。TikTok の例では 31,536,000 秒で、ちょうど 1 年です。更新時のレスポンスにも同じフィールドが含まれます。TikTok の更新例では 28,484,364 秒で、1 年未満です。更新のたびに 1 年が始まると想定せず、各レスポンスの値を確認してください。
どのように修正しますか?
アカウント所有者にアプリの再認可を依頼してください。TikTok アカウント保有者向けの認可 URL を共有します。承認されると、TikTok はアプリのリダイレクト URL に新しい auth_code を付けて戻します。この認可コードの有効期間は 10 分で、1 回のみ使用できます。/tt_user/oauth2/token/ でこれを交換し、新しいアクセストークンとリフレッシュトークンを取得して、保存されているペアを置き換えてください。所有者が以前に同じ権限を承認していた場合、TikTok はデフォルトで審査画面を省略し、そのままアプリに戻します。
40103 は 40107 および 40131 とどう違いますか?
リターンコード一覧には、更新に失敗した場合の 3 つのコードがあり、それぞれ異なる確認箇所を示しています。
- 40103:リフレッシュトークンが期限切れです。再認可のみが置き換えられます。
- 40107:リフレッシュトークンが無効または不正です。例えば、期限が切れない Marketing API トークンを更新するために送信された場合です。
- 40131:/
tt_user/oauth2/token/ または /tt_user/oauth2/refresh_token/ での認証エラーです。アプリ ID やシークレットの誤り、認可コードの期限切れ、リフレッシュトークンの無効または期限切れが原因です。
よくある間違い
- 40103 が出るまで次の再認可を計画しないこと。refresh_token_expires_in で期限を事前に把握できるため、更新が停止する前に所有者へ依頼できます。
- 更新のたびに 1 年がリセットされると考えること。TikTok の更新例では refresh_token_expires_in が 1 年未満を返すため、すべてのレスポンスの値を読み取ってください。
- 更新で返されたリフレッシュトークンを破棄すること。TikTok のリファレンスでは、次回の更新のために保持するよう案内されています。
Claude、ChatGPT、または独自のコードから利用できます。TikTok が更新を拒否した場合、ツールは TikTok のコードとメッセージを返します。ダッシュボードからアカウントを再接続すると、新しいトークンのペアが発行されます。料金は接続ごとに月額 US$ 9 から US$ 0.75 まで、接続を増やすほど下がります。最初の 3 日間は無料です。
よくある質問
Content Posting API のリフレッシュトークンも 1 年間有効ですか?
いいえ。Content Posting API で使われる TikTok for Developers のリフレッシュトークンは 180 日間有効です。1 年間の有効期間は API for Business のリフレッシュトークンに適用され、残り秒数は refresh_token_expires_in に表示されます。
期限切れの TikTok リフレッシュトークンを更新できますか?
いいえ。エラー 40103 に対する TikTok の対処法は、アカウント所有者による再認可です。これにより、新しいアクセストークンとリフレッシュトークンが発行されます。
所有者には TikTok の権限画面がもう一度表示されますか?
デフォルトでは表示されません。以前に同じ権限を承認していた場合、TikTok は審査画面を省略し、新しい認可コードを付けてアプリにリダイレクトします。
リフレッシュトークンの期限が切れた後、呼び出しはどうなりますか?
現在のアクセストークンの期限が切れるまでは動作し続けます。その後はトークンを更新できなくなるため、エラー 40102 で失敗します。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日