Recuperar y consultar datos enmascarados en Dropbox Sign

Actualizada Aug 18, 2026

Puedes usar campos enmascarados para ocultar la información confidencial de los firmantes. Toda la información de los campos enmascarados se ocultará y se reemplazará por asteriscos (p. ej., *****) en las actividades de devolución de llamada que se muestran en el panel de la API. En este artículo, te explicamos cómo recuperar y consultar estos datos enmascarados.

Consultar datos enmascarados

Hay tres formas de consultar los datos enmascarados:

Descargar los datos del documento en formato CSV

Al descargar los datos del documento en formato CSV, recibirás una hoja de Excel con información sobre la solicitud de firma con los valores de todos los campos, incluidos los campos enmascarados. Aprende a descargar documentos en formato CSV.

Nota: De forma predeterminada, solo los administradores pueden descargar los datos de los documentos en formato CSV. Sin embargo, los administradores pueden permitir que los remitentes descarguen los datos de los documentos como CSV.

Ejecutar una solicitud al punto final Solicitar firma

Al ejecutar una solicitud al terminal Solicitar firma, el objeto de respuesta incluirá los valores sin enmascarar. Para hacerlo, sigue estos pasos:

Inicia sesión en app.sign.dropbox.com.
Accede a la página del punto final Solicitar firma.
Selecciona Probar en la parte superior de la página.
Ingresa tu clave de API en Seguridad.
Haz clic en Parámetros.
Ingresa el signature_request_id de la solicitud de firma que contiene los campos enmascarados.
Haz clic en Enviar.

Nota: El campo con los datos enmascarados incluirá “masked”:true para indicar qué valores sin ocultar están enmascarados en el documento.

Consultar los objetos de respuesta de devolución de llamada

Puedes consultar los valores sin ocultar de los campos enmascarados en los objetos de respuesta de las actividades de devolución de llamada que se envían a las URL de devolución de llamada configuradas en tu cuenta. Esta opción te permite procesar la información dentro de tu flujo de trabajo.

Notas:

Si prefieres recibir valores ocultos en los objetos de respuesta de devolución de llamada de forma predeterminado, sigue estas instrucciones para enviar una solicitud al servicio de soporte de Dropbox.
Para obtener más información sobre las actividades de devolución de llamada, consulta nuestra Guía de actividades y devoluciones de llamada.

Consultar datos enmascarados desde el panel de la API: ejemplo

Este es un cuerpo de respuesta de una actividad de devolución de llamada publicada en el panel de la API en la que los datos están enmascarados con asteriscos:

- "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"
  }
}

A continuación, se incluye el cuerpo de respuesta tras ejecutar el punto final Solicitar firma utilizando el signature_request_id correspondiente. Esto muestra cuáles son los datos que estaban enmascarados.

- "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"
}
}

¿Este artículo te resultó útil?

¡Sí, gracias!

No mucho

Indícanos por qué no funcionó:

¡Gracias por informarnos!

El artículo no respondió a mi pregunta Los pasos del artículo no funcionan para mí El artículo me pareció confuso y difícil de leer Otros

Please enter feedback before submitting.

¡Gracias por tus comentarios!