公開されたウェブフォームまたは外部アプリケーションから OneTrust を非同期的に呼び出して、[ウェブフォームの構成]画面に表示されるリクエストを動的に作成できます。
注記
このドキュメントでは、Postman ツールを使用して API 統合をテストします。
メニューのを選択します。[ウェブフォームテンプレート]画面が表示されます。
-
公開されたウェブフォームをクリックします。[ウェブフォームのカスタマイズ]画面が開きます。
注記
この機能は、公開されたウェブフォームにのみ対応しています。新しいウェブフォームの作成の詳細については、「ウェブフォームの作成」を参照してください。
-
[統合]タブに移動し、[API]タブをクリックします。
-
API URL ブロックの[URL のコピー]ボタンをクリックします。
Postman で、[エンドポイント]フィールドから POST
を選択します。
-
[URL]フィールドに API URL を貼り付けます。
-
OneTrust の[API]タブで、API トークンブロックの[トークンのコピー]ボタンをクリックします。
Postman で、[ヘッダー]タブをクリックします。
[キー]フィールドにアクセストークンを入力します。
-
OneTrust の API トークンを[値]フィールドに貼り付けます。
-
OneTrust の[API]タブで、[想定されるペイロード]ブロックの[想定されるペイロードのコピー]ボタンをクリックします。
注記
ウェブフォームフィールドに対して行われた編集は、予想されるペイロードで動的に更新されます。
Postman で、[本文]タブをクリックします。
-
プレビュータイプとして[raw]を有効にします。
注記
選択したファイルタイプが[JSON]
であることを確認します。
-
想定されるペイロードを本文に貼り付けます。
ヒント
ペイロードを編集することで、リクエストの詳細を追加できます。リクエストを作成するのに送信しない追加のパラメータや NULL 値を持つパラメータを削除します(添付ファイルなしなど)。呼び出しは、null パラメーター値を使用して送信しません。
[送信]をクリックします。
-
ステータスコードを確認して、呼び出しが送信されたことを確認します。正しく実行された場合は、requestTraceId
値が返されるはずです。
requestTraceId
をコピーします。
[トレース ID によるリクエストステータス取得]エンドポイントを使用して、Postman で別の呼び出しを作成します。 GET /api/datasubject/v2/requestqueues/status/{traceId}
-
新しく作成された requestTraceID
をエンドポイントの末尾に追加します。
[ヘッダー]タブで、別の API キーを入力します。
[送信]をクリックします。
-
呼び出しが成功した場合は、creationstatus:SUCCESS
と新しい requestReId
が返されます。
OneTrust に戻り、一致する requestReId
を持つリクエストキューに、新しく作成されたリクエストが表示されるかどうかを確認します。