TikTok エラー 40131:トークンエンドポイントでの認証エラー
TikTok エラー 40131 は、/tt_user/oauth2/token/ または /tt_user/oauth2/refresh_token/ から返される認証エラーです。これらは TikTok アカウントのトークンを発行・更新するエンドポイントです。TikTok は原因として 3 つを挙げています。アプリ ID かシークレットの誤り、期限切れの認可コード、無効または期限切れのリフレッシュトークンです。返されたエンドポイントを見ると、最初に確認すべき入力が分かります。
easyCoexistence が両方のトークン呼び出しを代行します。
/tt_user/oauth2/token/ または /tt_user/oauth2/refresh_token/ での認証エラーに対する TikTok の戻りコードです。
Accounts API の認可コードの有効期間です。各コードは一度しか使えません。
リフレッシュトークンの有効期間です。期限が切れると、オーナーはアプリを再認可する必要があります。
末尾のスラッシュなしで呼び出すと生じうる HTTP エラーです。TikTok の付録に記載があります。
エラー 40131 とはどういう意味ですか?
TikTok アカウントのトークンを取得または更新するリクエストが、認証に失敗したことを意味します。戻りコードの付録では、40131 は次の 2 つのエンドポイントに対応しています。/tt_user/oauth2/token/ は認可コードをトークンに交換するエンドポイントで、/tt_user/oauth2/refresh_token/ はアクセストークンを更新するエンドポイントです。例のメッセージは「Authorization code is expired.」です。よくある原因は次の 3 つです。
- アプリ ID かシークレットが正しくありません。
- 認可コードの期限が切れています。
- リフレッシュトークンが無効または期限切れです。
/tt_user/oauth2/token/ で修正するには?
このエンドポイントで TikTok が挙げる 3 つの入力を確認してください。アプリ ID、シークレット、認可コードです。アプリ ID とシークレットは、TikTok API for Business のポータルで「My Apps」、「App Detail」、「Basic Information」の順に開くと確認できます。認可コードの有効期間は 10 分で、一度しか使えません。リダイレクトが届いたらすぐに交換し、古くなっている場合は認可をやり直してください。また、送信する redirect_uri は、アプリに設定したリダイレクト URL と一致している必要があります。
/tt_user/oauth2/refresh_token/ で修正するには?
有効なリフレッシュトークンを送信してください。リクエストに、そのアカウントについて最後に保存されたリフレッシュトークンと、正しいアプリ ID およびシークレットが含まれているか確認してください。リフレッシュトークンが期限切れになっているか、もう有効でない場合は、TikTok の付録の指示どおり、オーナーにアプリを再度認可してもらってください。再認可により、新しいアクセストークンと新しいリフレッシュトークンが発行されます。
1 つの原因だけを示す関連コードはありますか?
同じ付録には、これらの一部のケースについて、より限定的なコードが記載されています。それぞれ独自の説明があります。
- 40103:リフレッシュトークンが期限切れです。オーナーはアプリを再度認可する必要があります。
- 40107:リフレッシュトークンが無効または不正です。
- 40110:認可コードがキャンセルされたか、すでに使用されたか、期限切れです。
- 40113:アプリがブロックされているか存在しません。一般的な原因は、アプリ ID またはシークレットの誤りです。
よくある間違い
- 末尾のスラッシュを省略すること。TikTok の付録には、末尾の / がない /tt_user/oauth2/refresh_token では、戻りコードではなく「404 page not found」が返されることがあると記載されています。
- 認可コードを 2 回交換すること。認可コードは一度だけ、10 分間使えます。リロードや再試行されたコールバックでは、再び使うことはできません。
- アプリ ID とシークレットを確認する前に、オーナーに再認可を依頼すること。どちらかが誤っていると、新しい認可も同じ箇所で失敗します。
- 別のアプリの認証情報を使うこと。アプリ ID とシークレットは、オーナーが認可したアプリのものである必要があります。
TikTok のログインからリダイレクトされるとすぐに認可コードを交換し、24 時間有効なアクセストークンは、リフレッシュトークンを使って自動的に更新します。TikTok が更新を拒否した場合、ツールは TikTok のコードとメッセージを Claude、ChatGPT、または独自のコードに渡します。ダッシュボードからアカウントを再接続すると、新しい認可が始まります。料金は接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がって US$ 0.75 まで。最初の 3 日間は無料トライアルとしてご利用いただけます。
よくある質問
TikTok エラー 40131 を返すエンドポイントはどれですか?
/tt_user/oauth2/token/(認可コードをトークンに変換)と /tt_user/oauth2/refresh_token/(アクセストークンを更新)です。
TikTok のアプリ ID とシークレットはどこにありますか?
TikTok API for Business のポータルで、「My Apps」、「App Detail」、「Basic Information」の順に開いてください。
40131 は必ずオーナーの再接続が必要ですか?
いいえ。アプリ ID やシークレットの誤りは、アプリ自体の設定で修正できます。認可コードやリフレッシュトークンが期限切れの場合にのみ、新しい認可が必要です。
トークンリクエストでの TikTok 認可コードの有効期間はどれくらいですか?
10 分間で、一度の交換にしか使えません。その後は、TikTok の案内どおり認可の手順を最初からやり直してください。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日