Cómo recuperar y consultar datos enmascarados en Dropbox Sign

Actualización Aug 18, 2026

Puedes usar campos enmascarados para ocultar 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.

Cómo 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 como 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 como 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 punto final Solicitar firma, el objeto de respuesta incluirá los valores sin enmascarar. Solo tienes que seguir estos pasos:

Inicia sesión en app.sign.dropbox.com.
Ve a la página del punto final Solicitar firma.
Haz clic en Probar en la parte superior de la página.
Introduce tu clave de API en Seguridad.
Haz clic en Parámetros.
Introduce 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 enmascarar 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 predeterminada, sigue estas instrucciones para enviar una solicitud al servicio de asistencia 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 muestra el cuerpo de respuesta tras ejecutar el punto final Obtener solicitud de firma utilizando el signature_request_id correspondiente. Esto muestra 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"
}
}

¿Te ha resultado útil este artículo?

Sí, ¡gracias!

No mucho

Dinos por qué no te ha ayudado el artículo:

¡Gracias por informarnos!

El artículo no ha respondido a mi pregunta Los pasos señalados en el artículo no han funcionado en mi caso El artículo me parece confuso y difícil de lee Otro

Please enter feedback before submitting.

¡Gracias por tus comentarios!