Dropbox Sign でマスクされたデータを取得して表示する方法

更新 Aug 18, 2026

In this article

person icon

この記事の情報は、Dropbox Sign Premium プランの管理者に適用されます。

マスクされたフィールドを使用して、機密性の高い署名者情報を非表示にできます。API ダッシュボードに表示されるコールバックイベントにおいて、マスクされたフィールド情報はすべて非表示となり、アスタリスク(例:*****)に置き換えられます。この記事では、このマスクされたデータを取得して表示する方法について説明します。

マスクされたデータを表示する方法

マスクされたデータを表示する方法は 3 つあります。

ドキュメントデータを CSV 形式でダウンロード
ドキュメントデータを CSV 形式でダウンロードすると、マスクされたフィールドを含むすべてのフィールドの値とともに、署名依頼に関する情報が記載された Excel シートが届きます。ドキュメントを CSV 形式でダウンロードする方法をご覧ください。
highlighter icon

注:デフォルトでは、管理者のみがドキュメントデータを CSV 形式でダウンロードできます。ただし、管理者は送信者がドキュメントのデータをCSV形式でダウンロードできるように設定できます。

署名を取得エンドポイントへのリクエストを実行する

署名依頼の取得エンドポイントへのリクエストを実行すると、マスクされていない値を含む応答オブジェクトが返されます。次の手順に従ってください:

  1. app.sign.dropbox.com にログインします。
  2. 署名依頼の取得エンドポイントページに移動します。
  3. ページ上部の[試してみる]をクリックします。
  4. セキュリティ]の下に API キーを入力します。
  5. パラメーター]をクリックします。
  6. マスクされたフィールドを含む署名依頼の signature_request_id を入力します。
  7. 送信]をクリックします。
highlighter icon

注:マスキングされたデータを含むフィールドには、“masked”:true が含まれ、ドキュメント上でどのクリア値の応答がマスキングされているかを示します。

コールバック応答オブジェクトを表示する

アカウントに設定されているコールバック URL に報告するコールバックイベント応答オブジェクトで、マスクされたフィールドのマスクされていない値を表示できます。このオプションを使用すると、ワークフロー内で情報を処理できます。

highlighter icon

注:

API ダッシュボードからマスクされたデータを表示する:例

API ダッシュボードに投稿されたコールバックイベントの応答本文は次のとおりです。データはアスタリスクでマスクされています。

- "value": "*********"

{
"event": {
"event_type":"signature_request_signed",
"event_time":"1609432599",
"event_hash":"5118da82b71d394887382d21e2488ae7a029d7ab",
"event_metadata": {
"related_signature_id":"d91adbb59792d036264057",
"reported_for_account_id":"f0899a9b5354b22b6cc6b301",
"reported_for_app_id":"d8754524aaa29c3025bd3"
      }
  },
"account_guid":"f0899a9b5354b24263252b6cc6b301",
"client_id":"d8754524aaa6129c3025bd3",
"signature_request": {
"signature_request_id":"aaf05626ad486775234c3e4043",
"test_mode": true,
"title":"test masked SSN",
"original_title":"masked SSN",
"subject":"masked SSN",
"message": null,
"metadata": {
"signed_on_domain":"localhost"
  },
"created_at": 1609432502,
"is_complete": false,
"is_declined": false,
"has_error": false,
"custom_fields":[],
"response_data":[{
"name":"Signature1",
"type":"signature",
"required": true,
"api_id":"97f86e0633f7",
"value": null,
"signature_id":"d91adbb597920fcd036264057"
          },
          {
"name":"Masked SSN Field",
"type":"text",
"required": true,
"api_id":"acf4bb6fd352",
"value":"*********",
"signature_id":"d91adbb59792fcd036264057"
          }
      ],
"signing_url": null,
"signing_redirect_url": null,
"final_copy_uri":"/v3/signature_request/final_copy/aaf05626a1fafa35234c3e4043",
"files_url":"https://api.hellosign.com/v3/signature_request/files/aaf05626ad486775234c3e4043",
"details_url":"https://app.hellosign.com/home/manage?guid=aaf05626ad486775234c3e4043",
"requester_email_address":"jack@example.com",
"signatures":[{
"signature_id":"d91adbb5979d036264057",
"has_pin": false,
"has_sms_auth": false,
"signer_email_address":"jill@example.com",
"signer_name":"Jill",
"signer_role": 1,
"order": null,
"status_code":"signed",
"signed_at": 1609432599,
"last_viewed_at": 1609432578,
"last_reminded_at": null,
"error": null
   }],
"cc_email_addresses":[],
"template_ids": [
"7b3d2693ad423a39a2dd104"
      ],
"client_id":"d8754524aaa6129c3025bd3"
  }
} 

以下は、関連する signature_request_id を使用して署名依頼の取得エンドポイントを実行した後の応答本文です。これにより、マスクされたデータが公開されます。

- "value": "123-45-6789"

{
"signature_request": {
"signature_request_id": "aaf05626ad486775234c3e4043",
"test_mode": true,
"title": "test masked SSN",
"original_title": "masked SSN",
"subject": "masked SSN",
"message": null,
"metadata": {
"signed_on_domain": "localhost"
},
"created_at": 1609432502,
"is_complete": true,
"is_declined": false,
"has_error": false,
"custom_fields": [ ],
"response_data": [{
"name": "Signature1",
"type": "signature",
"required": true,
"api_id": "97f86e0633f7",
"value": null,
"signature_id": "d91adbb597920fcd036264057"
},
{
"name": "Masked SSN Field",
"type": "text",
"required": true,
"api_id": "e2b418c6-2498-44af-b73f-acf4bb6fd352",
"value": "123-45-6789",
"signature_id": "d91adbb59792fcd036264057"
"masked": true
}
],
"signing_url": null,
"signing_redirect_url": null,
"final_copy_uri": "/v3/signature_request/final_copy/aaf05626a1fafa35234c3e4043",
"files_url": "https://api.hellosign.com/v3/signature_request/files/aaf05626a1fafa35234c3e4043",
"details_url": "https://app.hellosign.com/home/manage?guid=aaf05626a1fafa35234c3e4043",
"requester_email_address": "hazem.hamed@hellosign.com",
"signatures": [{
"signature_id": "d91adbb5979d036264057",
"has_pin": false,
"has_sms_auth": false,
"signer_email_address": "jhondoe1@test.com",
"signer_name": "John Doe",
"signer_role": 1,
"order": null,
"status_code": "signed",
"signed_at": 1609432599,
"last_viewed_at": 1609432578,
"last_reminded_at": null,
"error": null
}],
"cc_email_addresses": [],
"template_ids": [
"7b3d2693ad423a39a2dd104"
],
"client_id": "d8754524aaa6129c3025bd3"
}
}
この記事は役立ちましたか?

この記事が役に立たなかった理由をお聞かせください。

ご意見ありがとうございます。

フィードバックありがとうございます。