TikTok エラー 40002:リクエストのパラメータエラー
TikTok エラー 40002 はパラメータエラーです。リクエスト内のフィールドが不足している、形式が正しくない、サポートされていない、または別のフィールドと矛盾している状態を指します。レスポンスのメッセージに問題が示されます(例:必須フィールドの欠落)。該当するフィールド(Accounts API の business_id、post_info、max_count など)をエンドポイントのリファレンスと照らして修正し、リクエストを再送してください。
easyCoexistence は、Claude、ChatGPT、またはお客様自身のコードが行うすべての TikTok 呼び出しに business_id を追加し、送信前に投稿を確認します。
TikTok のパラメータエラーの戻りコード。詳細はレスポンスのメッセージに記載されます。
TikTok の 40002 レスポンス例のステータス。失敗は status ではなく code フィールドで示されます。
Accounts API 経由で動画キャプションに入力できる文字数(UTF-16 で計測)。メンションは最大 30 件まで。
/business/comment/list/ の max_count で指定できるページあたりのコメント数。既定値は 20 です。
/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 が求められるため、これも控えておいてください。
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 のみを受け付けます。
動画 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 監視
確認日