如何在 Dropbox Sign 中检索和查看被屏蔽的数据

已更新 Aug 18, 2026

In this article

person icon

本文中的信息适用于 Dropbox Sign Premium 套餐的管理员。

您可以使用被屏蔽的字段来隐藏敏感的签字人信息。在 API 面板上显示的回调事件中,所有被屏蔽的字段信息将被隐藏,并被星号替代(例如 *****)。本文介绍了如何检索和查看这些被屏蔽的数据。

如何查看被屏蔽的数据

查看被屏蔽的数据有三种方法:

将文档数据下载为 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

注意:

  • 如果您希望默认在回调响应对象中接收屏蔽后的值,请按照以下说明向 Dropbox 支持团队提交请求。
  • 如需了解有关回调事件的更多信息,请参阅我们的事件和回调指南

从 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"
}
}
这篇文章有用吗?

请告诉我们为什么它没有帮助:

感谢您告诉我们!

谢谢您的意见!