エラーコード

最終更新日： 2025年5月14日
  • トピック：

作成対象：

  • 管理者

REST API エラーコードのリストと、エラーがアプリケーションに返される方法を以下で説明します。

例外の処理とログ

Marketo 向けに開発を行う場合、予期しない例外が発生した際にリクエストと応答がログに記録されることが重要です。期限切れの認証などの特定のタイプの例外は、再認証によって安全に処理できますが、他の例外ではサポートのインタラクションが必要になる場合があり、このシナリオでは常にリクエストと応答がリクエストされます。

エラータイプ

Marketo REST API は、通常の操作では次の 3 つの異なるタイプのエラーを返します。

  • HTTP レベル：これらのエラーは、4xx コードで示されます。
  • 応答レベル：これらのエラーは、JSON 応答の "errors" 配列に含まれます。
  • レコードレベル：これらのエラーは、JSON 応答の "result" 配列に含まれ、"status" フィールドと "reasons" 配列を使用して個々のレコードごとに示されます。

応答レベルおよびレコードレベルのエラータイプの場合、HTTP ステータスコード 200 が返されます。すべてのエラータイプについて、HTTP 理由フレーズはオプションであり、変更される可能性があるので、評価しないでください。

HTTP レベルのエラー

通常の操作状況では、Marketo は、413 Request Entity Too Large と 414 Request URI Too Long の 2 つの HTTP ステータスコードエラーのみを返します。これらは両方とも、エラーをキャッチし、リクエストを変更して再試行することで復元できますが、スマートコードプラクティスを使用すれば、実際にこのような問題が発生することはありません。

リクエストペイロードが 1 MB を超える場合や、「リード読み込み」のケースで 10 MB を超える場合、Marketo は 413 を返します。ほとんどのシナリオでは、これらの制限に達する可能性はほとんどありませんが、リクエストのサイズを確認するチェックを追加し、制限を超える原因となるレコードを新しいリクエストに移動することで、エンドポイントからこのエラーが返される状況を防ぐことができます。

GET リクエストの URI が 8 KB を超えると 414 が返されます。これを回避するには、クエリ文字列の長さがこの制限を超えていないかどうかを確認します。リクエストが POST メソッドに変更される場合は、追加のパラメーター _method=GET を指定して、クエリ文字列をリクエスト本文として入力します。これにより、URI の制限がなくなります。ほとんどの場合、この制限に達することはまれですが、GUID などの長い個別のフィルター値を持つ大量のレコードを取得する場合は、比較的よくで発生します。
ID エンドポイントは、401 Unauthorized エラーを返す場合があります。これは通常、クライアント ID やクライアント秘密鍵が無効であることが原因です。HTTP レベルのエラーコード

応答コード説明コメント
413リクエストエンティティが大きすぎますペイロードが 1 MB の制限を超えました。
414リクエスト URI が長すぎますリクエストの URI が 8 K を超えました。 リクエストは、URL にパラメーター `_method=GET` を含め、リクエストの本文に残りのクエリ文字列を含めて POST として再試行する必要があります。

応答レベルのエラー

応答レベルのエラーは、応答の success パラメーターが false に設定されている場合に発生し、次のように構造化されます。

{
    "requestId": "e42b#14272d07d78",
    "success": false,
    "errors": [
        {
            "code": "601",
            "message": "Unauthorized"
        }
    ]
}

"errors" 配列の各オブジェクトには、601 から 799 までの引用符で囲まれた整数である code と、エラーの理由をプレーンテキストで示す message の 2 つのメンバーがあります。6xx コードは常に、リクエストが完全に失敗し、実行されなかったことを示します。例えば、601「アクセストークンが無効です」があります。これは、再認証して新しいアクセストークンをリクエストに渡すことで復元できます。7xx エラーは、データが返されなかったか、無効な日付が含まれている、必須パラメータが欠落しているなど、リクエストが誤ってパラメーター化されたことにより、リクエストが失敗したことを示します。

応答レベルのエラーコード

この応答コードを返す API 呼び出しは、毎日の割り当て量やレート制限に対してカウントされません。

応答コード説明コメント
502ゲートウェイが正しくありませんリモートサーバーがエラーを返しました。タイムアウトの可能性があります。リクエストは、指数バックオフで再試行する必要があります。
601*アクセストークンが無効ですリクエストにアクセストークンパラメーターが含まれていましたが、値が有効なアクセストークンではありませんでした。
602*アクセストークンの有効期限が切れました呼び出しに含まれるアクセストークンは期限切れにより無効になりました。
603アクセス拒否認証は成功しましたが、ユーザにはこの API を呼び出すための十分な権限がありません。[追加の権限]（custom-services.md）をユーザロールに割り当てる必要があるか、IP ベースの API アクセスの許可リストを有効にする必要がある場合があります。
604*リクエストタイムアウトリクエストの実行時間が長すぎたか（例：データベース競合が発生した）、呼び出しのヘッダーで指定されたタイムアウト期間を超えました。
605*HTTP メソッドがサポートされていません「リードを同期」エンドポイントでは、GET はサポートされていません。POST を使用する必要があります。
606「%s」秒以内に最大レート制限「%s」を超えました過去 20 秒間の呼び出し回数が 100 を超えました
607毎日の割り当て量に達しました今日の呼び出し回数がサブスクリプションの割り当て量を超えました（毎日午前 12:00 CST にリセットされます）。>割り当て量は、管理／Web サービスメニューで確認できます。アカウントマネージャーを通じて、割り当て量を増やすことができます。
608*API は一時的に使用できません
609無効な JSONリクエストに含まれた本文が有効な JSON ではありません。
610リクエストされたリソースがありません呼び出しの URI が REST API リソースタイプと一致しませんでした。多くの場合、リクエスト URI のスペルが正しくないか、形式が正しくないことが原因です
611*システムエラー。すべての未処理の例外
612無効なコンテンツタイプこのエラーが表示された場合は、JSON 形式を指定するコンテンツタイプヘッダーをリクエストに追加します。例えば、「content type: application/json」を使用してみてください。詳しくは、この StackOverflow の質問を参照してください。
613無効な Multipart リクエストPOST の multipart コンテンツの形式が正しくありませんでした
614無効なサブスクリプション宛先のサブスクリプションが見つからないか、アクセスできません。このエラーは通常、一時的にアクセスできないことを示します。
615同時アクセス制限に達しました最大で、リクエストはサブスクリプションごとに一度に 10 個処理されます。既に 10 個のリクエストが進行中の場合、このエラーが返されます。
616無効なサブスクリプションタイプCustom Object Metadata API にアクセスするには、適切な Marketo サブスクリプションタイプが必要です。詳しくは、CSM にお問い合わせください。
701%s は空白にできませんリクエストでは、報告されたフィールドを空にすることはできません
702指定された検索シナリオのデータが見つかりません指定された検索パラメーターに一致するレコードはありません。 メモ：失敗した検索操作の多くは、「success = true」を返し、エラーは返さず、警告情報文字列を設定します。
703この機能は、サブスクリプションでは有効になっていませんユーザのサブスクリプションで有効になっていないベータ版機能
704無効な日付フォーマット
  • 正しい形式でない日付が指定されました
  • 無効な動的コンテンツ ID が指定されました
709ビジネスルール違反

テンプレートを使用せずにメールを作成しようとするなど、アセットの作成または更新の要件に違反しているので、呼び出しを実行できません。また、次の操作を実行しようとした際にも、このエラーが発生する可能性があります。

  • ソーシャルコンテンツを含むランディングページのコンテンツを取得。
  • 特定のアセットタイプを含むプログラムを複製（詳しくは、プログラムの複製を参照してください）。
  • ドラフトのないアセット（つまり、既に承認済みのアセット）を承認。
710親フォルダーが見つかりません指定した親フォルダーが見つかりませんでした
711互換性のないフォルダータイプ指定されたフォルダーは、リクエストを満たすのに適切なタイプではありませんでした
712個人取引先への結合操作が無効ですSalesforce 個人取引先であるリードを結合しようとしたことにより、「リードを結合」呼び出しが失敗しました。Salesforce 個人取引先は、Salesforce で統合する必要があります。
713一時的なエラーAPI 呼び出し時に、システムリソースが一時的に使用できませんでした。このエラーが発生した場合は、しばらく待ってからリクエストを再試行することをお勧めします。
714デフォルトのレコードタイプが見つかりませんデフォルトのレコードタイプが見つからなかったことにより、「リードを結合」呼び出しが失敗しました。
718ExternalSalesPersonID が見つかりません存在しない「ExternalSalesPersonID」値を使用して、「商談を同期」呼び出しが行われました。
719ロック待機タイムアウト例外「プログラムを複製」呼び出しが行われ、ロックの待機中にタイムアウトになりました。