Gemaskeerde gegevens ophalen en bekijken in Dropbox Sign

Bijgewerkt Aug 18, 2026

Je kunt gemaskeerde velden gebruiken om gevoelige informatie van de ondertekenaar te verbergen. Alle gemaskeerde veldinformatie wordt verborgen en vervangen door sterretjes (bijv. *****) bij callback-gebeurtenissen die worden weergegeven in het API-dashboard. In dit artikel wordt uitgelegd hoe je deze gemaskeerde gegevens kunt ophalen en bekijken.

Zo bekijk je gemaskeerde gegevens

Er zijn drie manieren om gemaskeerde gegevens te bekijken:

Download de documentgegevens als CSV

Door de documentgegevens als CSV te downloaden, ontvang je een Excel-werkblad met informatie over de handtekeningaanvraag met waarden van alle velden, inclusief gemaskeerde velden. Meer informatie over het downloaden van documenten als CSV.

Opmerking: Standaard kunnen alleen beheerders documentgegevens als CSV downloaden. Beheerders kunnen afzenders echter toestaan om documentgegevens als CSV te downloaden.

Een verzoek uitvoeren naar het eindpunt Handtekening ophalen

Als je een aanvraag uitvoert naar het eindpunt Handtekeningaanvraag ophalen, wordt een antwoordobject met ongemaskeerde waarden geretourneerd. Dit doe je als volgt:

Meld je aan op app.sign.dropbox.com.
Ga naar de eindpuntpagina Handtekeningaanvraag ontvangen.
Klik op Proberen bovenaan de pagina.
Voer je API-sleutel in onder Beveiliging.
Klik op Parameters.
Voer de signature_request_id van de handtekeningaanvraag met gemaskeerde velden in.
Klik op Verzenden.

Opmerking: Het veld met de gemaskeerde gegevens bevat “masked”:true om aan te geven welke antwoorden met duidelijke waarden op het document zijn gemaskeerd.

De callback-antwoordobjecten bekijken

Je kunt ongemaskeerde waarden voor gemaskeerde velden bekijken in de antwoordobjecten van de callback-gebeurtenis die rapporteren aan alle callback-URL's die op je account zijn ingesteld. Met deze optie kun je de informatie binnen je workflow verwerken.

Opmerkingen:

Als je liever standaard geredigeerde waarden ontvangt in de callback-antwoordobjecten, volg dan deze instructies om een aanvraag in te dienen bij Dropbox-support.
Raadpleeg voor meer informatie over callback-gebeurtenissen onze Gids voor gebeurtenissen en callbacks.

Gemaskeerde gegevens bekijken vanuit het API-dashboard: een voorbeeld

Hier zie je een antwoordtekst van een callback-gebeurtenis die op het API-dashboard is geplaatst, waarbij de gegevens zijn gemaskeerd met sterretjes:

- "waarde": "*********"

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

Hieronder vind je de responsbody na het uitvoeren van het eindpunt Handtekeningaanvraag ophalen met behulp van de gecorreleerde signature_request_id. Hierdoor worden de gemaskeerde gegevens zichtbaar.

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

Was dit artikel nuttig?

Ja, bedankt!

Niet echt

Laat ons weten waarom het niet hielp:

Bedankt voor je feedback!

Het artikel beantwoordde mijn vraag niet De stappen in het artikel werkten niet voor mij Ik vond dit artikel onduidelijk en moeilijk te lezen Overig

Please enter feedback before submitting.

Bedankt voor je feedback.