Salesforce

非同期リクエスト作成 API の使用

« Go Back
Information
非同期リクエスト作成 API の使用
UUID-c35a2967-4869-e091-b957-f3819f20d55e
Article Content

公開されたウェブフォームまたは外部アプリケーションから OneTrust を非同期的に呼び出して、[ウェブフォームの構成]画面に表示されるリクエストを動的に作成できます。

注記

このドキュメントでは、Postman ツールを使用して API 統合をテストします。

API URL をコピーするには

  1. [データ主体リクエスト]メニューの[ウェブフォーム]を選択します。[ウェブフォームテンプレート]画面が表示されます。

  2. 公開されたウェブフォームをクリックします。[ウェブフォームのカスタマイズ]画面が開きます。

    注記

    この機能は、公開されたウェブフォームにのみ対応しています。新しいウェブフォームの作成の詳細については、「ウェブフォームの作成」を参照してください。

  3. [統合]タブに移動し、[API]タブをクリックします。

    integrate-api-tab.png
  4. API URL ブロックの[URL のコピー]ボタンをクリックします。

    your-api-url.png
  5. Postman で、[エンドポイント]フィールドから POST を選択します。

  6. [URL]フィールドに API URL を貼り付けます。

    post-url-postman.png

API トークンをコピーするには

  1. OneTrust の[API]タブで、API トークンブロックの[トークンのコピー]ボタンをクリックします。

    your-api-token.png
  2. Postman で、[ヘッダー]タブをクリックします。

  3. [キー]フィールドにアクセストークンを入力します。

  4. OneTrust の API トークンを[値]フィールドに貼り付けます。

    access-token-postman.png

想定されるペイロードをコピーするには

  1. OneTrust の[API]タブで、[想定されるペイロード]ブロックの[想定されるペイロードのコピー]ボタンをクリックします。

    注記

    ウェブフォームフィールドに対して行われた編集は、予想されるペイロードで動的に更新されます。

    expected-payload.png
  2. Postman で、[本文]タブをクリックします。

  3. プレビュータイプとして[raw]を有効にします。

    注記

    選択したファイルタイプが[JSON]であることを確認します。

  4. 想定されるペイロードを本文に貼り付けます。

    ヒント

    ペイロードを編集することで、リクエストの詳細を追加できます。リクエストを作成するのに送信しない追加のパラメータや NULL 値を持つパラメータを削除します(添付ファイルなしなど)。呼び出しは、null パラメーター値を使用して送信しません。

    body-payload-postman.png
  5. [送信]をクリックします。

  6. ステータスコードを確認して、呼び出しが送信されたことを確認します。正しく実行された場合は、requestTraceId 値が返されるはずです。

    requesttraceid-postman.png
  7. requestTraceId をコピーします。

OneTrust でリクエストを検証するには

  1. [トレース ID によるリクエストステータス取得]エンドポイントを使用して、Postman で別の呼び出しを作成します。 GET /api/datasubject/v2/requestqueues/status/{traceId}

  2. 新しく作成された requestTraceID をエンドポイントの末尾に追加します。

    requesttraceid-url-get.png
  3. [ヘッダー]タブで、別の API キーを入力します。

  4. [送信]をクリックします。

  5. 呼び出しが成功した場合は、creationstatus:SUCCESS と新しい requestReId が返されます。

    requestReID2.png
  6. OneTrust に戻り、一致する requestReId を持つリクエストキューに、新しく作成されたリクエストが表示されるかどうかを確認します。

 
Article Visibility
5,746
Translation
Japanese
Not Checked

Powered by