TikTok API 接続が止まる理由と、接続を維持する方法
TikTok API for Business の接続は、24 時間のアクセストークンが更新されないとき、1 年のリフレッシュトークンが期限切れになったとき、アカウントのオーナーがアプリのアクセス権を削除したとき、または送信されたトークンが欠けている、もしくは誤っているときに止まります。TikTok はトークンに関する原因を 40102、40103、40104、40105 として返します。期限より前に更新し、各アカウントを定期的に確認し、年が終わる前にオーナーへ再認可を依頼すれば、接続を維持できます。
easyCoexistence は、各 TikTok 接続を自動で維持します。
API for Business における TikTok アカウントアクセストークンの有効期間。/tt_user/oauth2/refresh_token/ で更新します。
リフレッシュトークンの有効期間。期限が切れると、アカウントのオーナーはアプリを再度認可する必要があります。
TikTok が投稿を処理中にオーナーがアプリのアクセス権を削除した場合の失敗理由。TikTok は再試行しないよう案内しています。
オーナーの認可が期限切れになったり取り消されたりすると、TikTok がそのアカウントについて送信を停止するイベント。
TikTok for Developers の authorization.removed が発生する理由:ユーザーが接続を解除した、アカウントが削除された、年齢が変わった、アカウント停止になった、または開発者が取り消した場合。
easyCoexistence が接続済みの各 TikTok アカウントを確認する頻度。24 時間トークンは自動で更新し、再接続が必要な場合はメールでお知らせします。
TikTok API の接続が止まるのはなぜですか?
原因はいくつかあり、多くはアカウントのトークンかオーナーの同意に関係しています。接続が完全に止まるものもあれば、一部のリクエストは拒否される一方で、残りは応答し続ける中途半端な状態になるものもあります:
各原因はどのエラーを返し、どう直しますか?
TikTok のコードフィールドが大半を示します。このコードは、エラーステータスではなく HTTP 200 の応答の中に含まれます。投稿ステータスには独自の失敗理由も加わります。40100 は、スロットリングされたリクエストが接続切れに見えることがあるため表に含めています。それぞれの意味と対処法は次のとおりです:
| What it means | The fix | |
|---|---|---|
| 40102 | The access token is past its 24 hours | Renew with the refresh token, store both new tokens, repeat the call |
| 40103 | The refresh token has expired | A new authorization by the owner; nothing renews it |
| 40104 | The request carried no access token | A bug in the request: send the Access-Token header |
| 40105 | The access token is invalid or incorrect | Check what was sent, renew, then ask the owner to authorize again |
| 40107 | The refresh token is invalid or incorrect | Send the refresh token from the latest response, or a new authorization |
| 40131 | Authentication failed at a token endpoint | Check the app ID and secret, then the code or the refresh token |
| 40001 | A permission or scope is missing | Add it to the app, then have the owner authorize again |
| auth_removed | Access was removed while a post was processing | No retry; publish again after a new authorization |
| 40100 | Throttled, not disconnected | Pause the endpoint 5 minutes; the token still works |
トークンの有効期間と、更新すべきタイミングは?
API for Business では、アクセストークンの有効期間は 24 時間です。各トークン応答の expires_in に残りの秒数が入ります。リフレッシュトークンの有効期間は 1 年で、残り時間は refresh_token_expires_in にあります。リクエストが失敗するのを待つのではなく、トークンの期限が切れるよりずっと前に、スケジュールに沿って更新してください。また、更新のたびに返される新しいリフレッシュトークンを保存してください。TikTok はこのフィールドについて、保持するよう案内しています。refresh_token_expires_in は期限として扱ってください。TikTok の更新例では、新たに 1 年が始まるのではなく、このカウントダウンが進みます。
オーナーがアプリのアクセス権を削除するとどうなりますか?
アプリは、オーナーが許可した Accounts API の権限を失うため、そのトークンによるリクエストは機能しなくなります。TikTok は、これを知らせる API for Business のイベントを文書化していません。オーナーはいつでも TikTok アプリの「設定とプライバシー」「セキュリティ」「アプリの権限を管理」「アクセスを削除」から削除できます。兆候は別の場所に現れます。TikTok が処理中だった投稿は auth_removed で失敗します。TikTok は再試行しないよう案内しています。また、そのアカウントの comment.update イベントが届かなくなります。
アカウント種別が変わると、接続にどんな影響がありますか?
TikTok は、この変更に関連するトークンのエラーを文書で定めていません。変わるのは API が返す内容です。unique_video_views、daily_new_followers、audience_activity などのデータには、Advanced Access または Verified Business Account が必要です。Mentions API と Business Messaging API も同様です。非公開アカウントの privacy_level_options には PUBLIC_TO_EVERYONE が含まれません。2026 年 10 月 16 日以降、is_business_account は Verified Business Account の場合のみ true を返し、has_advanced_access は Advanced Access の有無を示します。その両方を user.account.type の下で読めば、リクエストが失敗する前に変更を把握できます。
顧客より先に接続切れを見つけるには?
投稿があるかどうかに関係なく動く確認を用意します:
- スケジュールに沿って、アカウントごとに軽いリクエストを行います。例:fields として username を指定した /business/get/。トークンが機能しなくなると、トークンのエラーが返されます。
- /
tt_user/token_info/get/ は権限が不要で、トークンのスコープを返します。機能が呼び出す権限を今も満たしているかを確認できます。 - 各応答を受け取るたびに
refresh_token_expires_inを日付に変換し、数週間前にオーナーへリマインダーを送ります。 - 通常コメントを受け取るアカウントで comment.update が届かない場合は注意してください。TikTok は認可が期限切れになったり取り消されたりすると、これらのイベントを停止します。
- 40102、40103、40104、40105 をアカウントごとに集計し、多数のアカウントの中で失敗しているものを目立たせます。
アカウントを再接続するには?
同じアカウントで認可をもう一度実行します。TikTok アカウントオーナーの認可 URL を共有し、戻り先をアカウントに結び付ける state 値を含めます。オーナーに権限画面を再び表示させたい場合は disable_auto_auth=1 を指定します。新しい auth_code は 10 分以内に /tt_user/oauth2/token/ で交換し、保存しておいた両方のトークンを置き換えます。open_id は、TikTok がアカウントに付与するアプリ固有の ID です。新しいトークンは、この open_id で保存済みのレコードと照合し、新しいレコードを作らないでください。
Content Posting API の接続も同じように期限切れになりますか?
いいえ。Content Posting API と Display API を提供する TikTok for Developers は、2026 年 11 月 2 日にトークンのページを更新しました。ユーザーのアクセストークンは 2 時間以内に期限切れになり、リフレッシュトークンは最初に発行されてから 180 日間有効です。リフレッシュトークンはローテーションされるため、更新が成功するたびに新しいものが返され、送信したものは直ちに無効になります。置き換えられたトークンを使い続けるサーバーでは、以降の更新が失敗し、ユーザーは再度認可する必要があります。不正なリフレッシュトークンは invalid_grant で失敗し、不正なアクセストークンは access_token_invalid と HTTP 401 で失敗します。authorization.removed の Webhook には、ユーザーが離脱した理由が含まれます。
easyCoexistence は TikTok の接続を維持するために何をしていますか?
easyCoexistence が自動で更新と確認を行い、オーナーにしか直せない場合は知らせます:
- 更新:残り 15 分未満になったリクエストの前、または残り 8 時間未満になった確認の中で行います。そのたびに新しいリフレッシュトークンと期限を保存します。
- アカウントごとに同時に更新するのは一度だけなので、同時に届いたリクエストは同じ更新を共有します。
- 確認:アカウントのユーザー名を指定した /business/get/ のリクエストを約 6 時間ごとに行います。
- トークンが拒否された場合(40102、40104、40105):チャネルには「再接続が必要」と表示され、オーナーにメールが 1 通届きます。プラットフォームには channel.disconnected が届き、TikTok のメッセージが
disconnected_reasonとして含まれます。 - それまでは、ツールがアカウントの再接続が必要だと応答し、予約投稿は TikTok に届く代わりに reconnect として失敗します。
- 再接続:チャネルのページで「TikTok を接続」を押す、または新しい接続セッションを作ると再度サインインでき、
account_idとイベントの送信先は同じまま維持されます。
設定方法
- Store both tokens with datesSave access_token, refresh_token, open_id and scope, and turn expires_in and refresh_token_expires_in into dates as each response arrives.
- Renew ahead of the dayCall /tt_user/oauth2/refresh_token/ well before the 24 hours end, one renewal per account at a time, and keep the refresh token it returns.
- Check each accountMake one light call per account on a schedule and record any 40102, 40103, 40104 or 40105 against that account.
- Ask before the year endsSend the owner the authorization URL before refresh_token_expires_in runs out, and replace both tokens when the new code arrives.
- Reconnect on a token errorWhen renewal fails or the token is refused, stop calling for that account and send its owner the authorization URL.
よくある間違い
- コメントの Webhook が静かだからといって、アカウントも静かだとは限りません。TikTok は認可が終わるとアカウントの comment.update を停止するため、イベントを待つのではなくアカウントを確認してください。
- 新しいレコードへ再接続しないでください。新しいトークンは、TikTok がアカウントに付与するアプリ固有の ID である open_id で照合し、保存済みのレコードをその場で更新して、履歴と設定を残してください。
- 同じリフレッシュトークンで 40103 や 40107 を再試行しないでください。どちらも再試行では解消しません。前者には新しい認可が必要で、後者には最新の応答に含まれるリフレッシュトークンか、新しい認可が必要です。
- 40100 を接続切れと読まないでください。これはスロットリングされたリクエストです。エンドポイントを 5 分間停止するか、1 日の上限に達した後は 00:00 UTC まで停止してください。同じトークンはそのまま機能し続けます。
24 時間のトークンを前もって更新し、約 6 時間ごとにアカウントを確認します。TikTok がトークンを拒否すると、チャネルを「再接続が必要」にしてメールで知らせます。Claude、ChatGPT、独自のプラットフォームのいずれでも利用できます。接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料トライアルです。
よくある質問
オーナーが関与しなくても TikTok API の接続は永続しますか?
いいえ。更新によって維持できるのは、リフレッシュトークンの 1 年が最大です。その後は、アカウントオーナーによる新しい認可が、TikTok が文書化している方法です。
複数のアカウントの TikTok 接続が同時に失敗したのはなぜですか?
アカウントより先にアプリを確認してください。40113 は、アプリがブロックされているか、ID とシークレットが一致しないことを意味します。また TikTok は、不正利用を理由にアプリの Accounts API アクセスを取り消すことがあります。
新機能を追加すると、TikTok アカウントの再接続が必要になりますか?
オーナーが許可していないスコープが必要な場合は、はい。トークンは認可時に承認されたスコープを保持するため、機能を追加するにはオーナーがアプリを再度認可する必要があります。
アカウントの再接続が必要な間、予約済みの TikTok 投稿はどうなりますか?
easyCoexistence では、予定時刻に TikTok へ届く代わりに reconnect として失敗し、オーナーにメールが届きます。アカウントが再接続されたら、「再試行」で投稿を送信できます。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日