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

TikTok エラー 40002:リクエストのパラメータエラー

TikTok エラー 40002 はパラメータエラーです。リクエスト内のフィールドが不足している、形式が正しくない、サポートされていない、または別のフィールドと矛盾している状態を指します。レスポンスのメッセージに問題が示されます(例:必須フィールドの欠落)。該当するフィールド(Accounts API の business_id、post_info、max_count など)をエンドポイントのリファレンスと照らして修正し、リクエストを再送してください。

easyCoexistence は、Claude、ChatGPT、またはお客様自身のコードが行うすべての TikTok 呼び出しに business_id を追加し、送信前に投稿を確認します。

40002

TikTok のパラメータエラーの戻りコード。詳細はレスポンスのメッセージに記載されます。

HTTP 200

TikTok の 40002 レスポンス例のステータス。失敗は status ではなく code フィールドで示されます。

2,200

Accounts API 経由で動画キャプションに入力できる文字数(UTF-16 で計測)。メンションは最大 30 件まで。

1 to 30

/business/comment/list/ の max_count で指定できるページあたりのコメント数。既定値は 20 です。

60 days

/business/get/ でアカウントのインサイトを読み取る際、start_date に指定できる最も古い日付。

エラー 40002 とは何ですか?

1 つ以上のパラメータがエンドポイントの受け付ける条件に合っていません。TikTok の戻りコード一覧では、40002 はパラメータエラーとして記載されており、詳細はエラーメッセージで確認するよう案内されています。挙げられている原因は、必須フィールドの欠落、形式の誤り、サポートされていないフィールドや値、相互に矛盾するフィールド、データ精度の不正、無効な番号です。

レスポンスはどう読みますか?

まずメッセージを確認してください。メッセージにはフィールド名が含まれています。TikTok 自身の例(下記)では、HTTP 200 で「Missing required field(s): account_id.」というメッセージが返されます。付録にある別の例では「Time format should be %Y-%m-%dT%H:%M.」と書かれています。TikTok のリファレンスでは問い合わせの際に request_id が求められるため、これも控えておいてください。

TikTok's example 40002 response
HTTPS/1.1 200 OK
{
    "code": 40002,
    "message": "Missing required field(s): account_id.",
    "request_id": "2022110918305001025108614416C7CC00"
}

確認すべき Accounts API のルールは?

各エンドポイントのリファレンスが独自の規則を定めています。以下は、接続が投稿、コメント処理、インサイト取得の呼び出しで適用されるルールです:

  • すべての呼び出しで business_id を指定します。アカウントのアクセストークンと一緒に返された open_id を設定してください。
  • 動画投稿では video_url と post_info の両方が必須です。post_info は空の場合でも必ず送信します。キャプションは最大 2,200 文字です。
  • 写真投稿では、photo_images に最大 35 件の画像 URL、アカウントが許可する privacy_level、最大 90 文字のタイトルを指定します。
  • コメントでは、video_id に /business/video/list/ から取得した投稿の item_id を指定します。max_count は 1 から 30 まで、comment_ids は最大 30 件です。
  • 返信では、最大 1,200 文字のテキスト、またはその代わりに画像を指定します。
  • インサイトでは、2021-06-01 のような UTC の日付を指定します。さかのぼれるのは最大 60 日までです。

エラーはどう修正しますか?

メッセージが示すフィールドをエンドポイントのリファレンスで探し、修正してリクエストを再送してください。エラーはリクエストそのものを示すため、変更せずに送ると同じコードが返ります。プライバシー設定やコメントの有効化など、アカウントに依存する値は、投稿の前に /business/video/settings/ から許可される選択肢を確認してください。

メディアファイルの問題はどうですか?

これらは呼び出しの後で TikTok が報告します。投稿用エンドポイントは、TikTok がファイルをダウンロードしている間、投稿タスク用の share_id を返します。ファイルがルールに違反している場合、/business/publish/status/ は FAILED を返し、file_format_check_failed、frame_rate_check_failed、picture_size_check_failed などの理由が付きます。TikTok はこれらの理由を再試行不可としているため、ファイル自体を変更する必要があります。

よくある間違い

  • 同じリクエストを再送すること。40002 はパラメータを示すため、メッセージが指すフィールドを修正するまで何も変わりません。
  • 配列パラメータを文字列として送ること。fields のような項目は、TikTok の例 ["display_name", "profile_image"] のように JSON 配列で送信します。
  • すべてのアカウントで同じプライバシー設定を使うこと。公開アカウントと非公開アカウントで選択肢が異なるため、先に /business/video/settings/ の privacy_level_options を確認してください。
  • コメントが無効化されたアカウントで disable_comment を false に設定すること。comment_disabled が true の場合、TikTok は true のみを受け付けます。
EasyCoexistence で実現する

動画 1 本、または画像 1〜35 枚で、リンクは HTTPS である必要があります。TikTok は JPEG か WebP のみを受け付けるため、PNG 写真は拒否されます。それでも TikTok が 40002 を返す場合、ツールはそのコードとメッセージを返すので、AI がフィールドを修正して再試行できます。接続ごとに月額 US$ 9 から US$ 0.75 まで、接続を増やすほど下がります。最初の 3 日間は無料です。

よくある質問

TikTok API でパラメータエラーとは何ですか?

戻りコード 40002 のことです。リクエスト内のフィールドが不足しているか、形式が正しくないか、サポートされていないか、別のフィールドと矛盾しており、どのフィールドかはメッセージに記載されます。

TikTok が HTTP 200 で 40002 を返すのはなぜですか?

TikTok の戻りコードは HTTP ステータスより優先されるため、コードが 0 ではない 200 レスポンスも失敗した呼び出しです。

40002 は再試行すべきですか?

リクエストを変更してからのみ再試行してください。パラメータがエラーの原因なので、メッセージが指すフィールドを修正してから再送します。

動画ファイルの問題はどこに表示されますか?

投稿ステータスに表示されます。TikTok がメディアをダウンロードした後、ルールに違反するファイルがあると /business/publish/status/ は FAILED を返し、失敗したチェック名を理由に示します。

続きを読む

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

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

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

確認日