Webhook および接続コンテンツリクエストのトラブルシューティング

この記事では、Webhook とConnected Content の一般的なエラーコードをトラブルシューティングする方法について説明し、リクエストでこれらのエラーがどのように発生するかについても詳しく説明します。

4XXエラー

4XX エラーは、エンドポイントに送信された要求に問題があることを示します。これらのエラーは、通常、不正な形式のパラメータ、認証ヘッダーの欠落、不正なURL など、誤ったリクエストによって発生します。

エラーコードの詳細と解決する手順については、次の表を参照してください。

エラーコード	意味	解決する手順
400 不正なリクエスト	リクエストに無効な構文があります。	構文エラーがないか要求ペイロードを確認します。 すべての必須フィールドが含まれ、正しくフォーマットされていることを確認します。 JSON ペイロードを送信する場合は、JSON 構造を検証します。
401 不正	リクエストにはユーザー認証が必要です。	正しい認証資格情報(API キーやトークンなど) がリクエストヘッダーに含まれていることを確認します。 エンドポイントにアクセスするためのユーザー権限があることを確認します。
403禁	エンドポイントはリクエストを理解しますが、承認は拒否します。	API キーまたはトークンに必要な権限があるかどうかを確認します。 エンドポイントにアクセスするためのユーザー権限があることを確認します。
404 見つかりません	エンドポイントは、要求されたリソースを見つけることができません。	エンドポイントのURL にタイプミスや不正なパスがないかどうかを確認します。 アクセスしようとしているリソースが存在することを確認します。
405 メソッドが許可されていません	リクエストメソッドはエンドポイントによって認識されますが、ターゲットリソースによってサポートされていません。	リクエストで使用されているHTTP メソッド(DELETE、GET、POST、PUT) を確認します。 エンドポイントが使用しているメソッドをサポートしていることを確認します。
408 リクエストタイムアウト	エンドポイントが要求の処理をタイムアウトしました。	リクエストで使用されているHTTP メソッド(DELETE、GET、POST、PUT) を確認します。 エンドポイントが使用しているメソッドをサポートしていることを確認します。
409 競合	リソースの現在の状態と競合するため、要求は不完全です。	リクエストで使用されているHTTP メソッド(DELETE、GET、POST、PUT) を確認します。 エンドポイントが使用しているメソッドをサポートしていることを確認します。
429 リクエストが多すぎる	特定の時間内に送信されたリクエストが多すぎます。	キャンペーンまたはキャンバスステップのレート制限を下げます。

5XXエラー

5XX エラーは、エンドポイントに問題があることを示します。これらのエラーは通常、サーバー側の問題によって発生します。

エラーコード	意味
500 内部サーバーエラー	エンドポイントは、要求の完了を妨げる予期しない条件を検出しました。
502 不正なゲートウェイ	エンドポイントは、アップストリームサーバーから無効な応答を受信しました。
503 サービス利用不可	エンドポイントは、現在、一時的な過負荷またはメンテナンスのために要求を処理できません。
504 ゲートウェイタイムアウト	エンドポイントは、アップストリームサーバーからタイムリーな応答を受け取りませんでした。
599 接続エラー	エンドポイントへの接続を確立しようとしたときに、ブレーズでネットワーク接続タイムアウトエラーが発生しました。つまり、エンドポイントが不安定またはダウンしている可能性があります。

5XX エラーの解決

一般的な5XX エラーのトラブルシューティングのヒントを次に示します。

• Message Activity Logで利用可能な特定の詳細については、エラーメッセージを確認してください。Webhook の場合は、Braze ホームページのPerformance Over Time セクションに移動し、Webhook の統計を選択します。ここから、エラーが発生した日時を示すタイムスタンプが見つかります。
• エンドポイントを過負荷にするリクエストが多すぎないことを確認します。一括で送信するか、レート制限を調整してエラーが発生しないかどうかを確認できます。