この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

SOAP API 開発者ガイド

SOAP API の使用開始
SOAP API の概要
API コールで使用されるコアデータ型
Enterprise WSDL での Tooling API オブジェクト
API コールの基礎
エラー処理
セキュリティと API
Partner WSDL の使用
参照
Salesforce 機能での API の使用
用語集
PDF

エラー処理

API コールは、クライアントアプリケーションがランタイムエラーを識別し解決するために使用できるエラーデータを返します。ほとんどの API コールでは、エラーが発生すると、API によって次のようなエラー処理が行われます。

  • 不正に作成されたメッセージ、失敗した認証、または同様の問題によるエラーについて、API は、関連する ExceptionCode を使用して SOAP エラーメッセージを返します。
  • 多くのコールについて、クエリ特有の問題によってエラーが発生する場合、API は、Error を返します。たとえば、create() に 200 を超えるオブジェクトが含まれる場合などです。

セッション終了のエラー処理

login() コールでサインオンする場合、新しいクライアントセッションが開始し、対応する一意のセッション ID が生成されます。セッションは、前もって決定された非活動状態の期間の後、自動的に終了します。非活動状態の期間の長さは、[設定] の [セキュリティのコントロール] をクリックすることによって Salesforce で設定できます。デフォルト値は 120 分 (2 時間) です。API コールを行うと、非活動状態タイマーがゼロにリセットされます。

セッションが終了すると、例外コード INVALID_SESSION_ID が返されます。この場合、login() コールを再度呼び出す必要があります。

エラー処理の詳細

エラーについての詳細は、次のトピックを参照してください。