Come recuperare e visualizzare i dati mascherati in Dropbox Sign

Aggiornato Aug 18, 2026

Puoi utilizzare i campi mascherati per nascondere le informazioni sensibili del firmatario. Tutte le informazioni dei campi mascherati verranno nascoste e sostituite da asterischi (ad esempio *****) negli eventi di callback visualizzati nella Dashboard API. Questo articolo spiega come recuperare e visualizzare questi dati mascherati.

Come visualizzare i dati mascherati

Esistono tre modi per visualizzare i dati mascherati:

Scarica i dati del documento in formato CSV

Scaricando i dati del documento in formato CSV, riceverai un foglio Excel con informazioni sulla richiesta di firma con i valori di tutti i campi, inclusi quelli mascherati. Scopri come scaricare i documenti in formato CSV.

Nota: per impostazione predefinita, solo gli amministratori possono scaricare i dati di un documento in formato CSV. Tuttavia, gli amministratori possono consentire ai mittenti di scaricare i dati del documento in formato CSV.

Esecuzione di una richiesta all'endpoint Ottieni firma

L'esecuzione di una richiesta all'endpoint Ottieni richiesta di firma restituirà un oggetto di risposta con valori non mascherati. A tale scopo:

Accedi ad app.sign.dropbox.com.
Vai alla pagina dell'endpoint Ottieni richiesta di firma.
Fai clic su Prova nella parte superiore della pagina.
Inserisci la tua chiave API nella sezione Sicurezza.
Fai clic su Parametri.
Inserisci l'id_richiesta_firma della richiesta di firma con campi mascherati.
Fai clic su Invia.

Nota: il campo con i dati mascherati includerà “masked”:true per indicare quali risposte con valore chiaro sono mascherate sul documento.

Visualizza gli oggetti di risposta di callback

Puoi visualizzare i valori non mascherati per i campi mascherati negli oggetti di risposta dell'evento di callback che fanno riferimento a qualsiasi URL di callback impostato sul tuo account. Questa opzione ti consente di elaborare le informazioni all'interno del tuo flusso di lavoro.

Note:

Se preferisci ricevere valori oscurati negli oggetti di risposta di callback per impostazione predefinita, segui queste istruzioni per inviare una richiesta al supporto di Dropbox.
Per ulteriori informazioni sugli eventi di callback, consulta la nostra Guida a eventi e callback.

Visualizzazione dei dati mascherati dalla Dashboard API: un esempio

Ecco un corpo di risposta di un evento di callback pubblicato sulla Dashboard API in cui i dati sono mascherati con asterischi:

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

Di seguito è riportato il corpo della risposta dopo l'esecuzione dell'endpoint Ottieni richiesta di firma utilizzando il relativo id_richiesta_firma. Questo espone i dati mascherati.

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

Questo articolo ti è risultato utile?

Sì, grazie!

Non proprio

Comunicaci la ragione per cui l’articolo non è stato utile:

Grazie per il tuo feedback.

L’articolo non ha risposto alla mia domanda I passaggi dell’articolo non hanno funzionato per me Ho trovato questo articolo confuso e difficile da leggere Altro

Please enter feedback before submitting.

Grazie per i tuoi commenti!