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

ステップ 1: API で認証する

要求を発行する前に、API で認証する必要があります。

API への接続を正常に認証するには、次の前提条件を満たしている必要があります。

Pardot API に対するすべての要求は、SSL で暗号化された接続を介して行う必要があります。
認証要求では、HTTP POST を使用する必要があります。
API 要求を送信する Pardot ユーザアカウントの email、password、および user_key を取得します ([私の設定] にあるアプリケーションで入手可能)。

以上の要件が満たされたら、API キーを取得します。ユーザキーと API キーは、どちらも個々のユーザに固有です。API キーは、60 分間有効です。これに対し、ユーザキーは無期限で有効です。認証を行うには、次の要求を発行します (italics で示される値を、自分のアカウントの値で置き換えます)。

1POST: https://pi.pardot.com/api/login/version/3
2
3message body: email=email&password=password&user_key=user_key

パラメータ	説明
email	ユーザアカウントのメールアドレス
password	ユーザアカウントのパスワード
user_key	ユーザアカウントの、32 ビットで 16 進数のユーザキー

すべてのパラメータは必須です。認証に成功すると、32 文字で 16 進数の API キーが次の形式で返されます。

1<rsp stat="ok" version="1.0">
2
3    <api_key>5a1698a233e73d7c8ccd60d775fbc68a</api_key>
4
5</rsp>

認証に失敗すると、次の応答が返されます。

1<rsp stat="fail" version="1.0">
2
3    <err code="15">Login failed</err>
4
5</rsp>

以降の認証要求では、現在の有効な API キーが返されるか、以前のキーが期限切れの場合は新しく生成された API キーが返されます。

Salesforce1 Platform API サービスガイド

ステップ 1: API で認証する