Como recuperar e visualizar dados mascarados no Dropbox Sign

Atualizado Aug 18, 2026

Você pode usar campos mascarados para ocultar informações confidenciais do signatário. Todas as informações do campo mascarado serão ocultadas e substituídas por asteriscos (por exemplo, *****) em eventos de retorno de chamada exibidos no Painel da API. Este artigo explica como recuperar e visualizar esses dados mascarados.

Como visualizar dados mascarados

Existem três maneiras de visualizar dados mascarados:

Baixar os dados do documento como um arquivo CSV

Ao baixar os dados do documento como um arquivo CSV, você receberá uma planilha do Excel com informações sobre a solicitação de assinatura com valores de todos os campos, incluindo campos ocultos. Saiba como baixar documentos como um arquivo CSV.

Observação: por padrão, apenas os administradores podem baixar os dados do documento em formato CSV. No entanto, os administradores podem permitir que os remetentes baixem os dados do documento como um arquivo CSV.

Execute uma solicitação para o ponto de extremidade Get Signature

A execução de uma solicitação para o ponto de extremidade Get Signature Request retornará um objeto de resposta com os valores desmascarados. Para fazer isso:

Entre em app.sign.dropbox.com.
Navegue até a página do ponto de extremidade Get Signature Request .
Na parte superior da página, clique em Experimente.
Insira sua chave de API em Segurança.
Clique em Parâmetros.
Insira o signature_request_id da solicitação de assinatura com campos mascarados.
Clique em Enviar.

Observação: o campo com os dados mascarados incluirá “masked”:true para indicar quais respostas de valor claro estão mascaradas no documento.

Visualizar os objetos de resposta de retorno de chamada

Você pode visualizar valores não mascarados para campos mascarados nos objetos de resposta de evento de retorno de chamada que reportam a quaisquer URLs de retorno de chamada definidas na sua conta. Essa opção permite que você processe as informações dentro do seu fluxo de trabalho.

Observação:

Se preferir receber valores redigidos nos objetos de resposta de retorno de chamada por padrão, siga estas instruções para enviar uma solicitação ao atendimento do Dropbox.
Para obter mais informações sobre eventos de retorno de chamada, consulte nosso Guia de eventos e retornos de chamada.

Visualização de dados mascarados no Painel da API: um exemplo

Aqui está um corpo de resposta de um evento de retorno de chamada publicado no Painel da API, onde os dados são mascarados com asteriscos:

- "valor": "*********"

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

Abaixo está o corpo da resposta após executar o ponto de extremidade Get Signature Request usando o signature_request_id correspondente. Isso expõe os dados mascarados.

- "valor": "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 artigo foi útil?

Sim, claro!

Na verdade não

Conte-nos como e por que isso não ajudou:

Obrigado por nos informar!

O artigo não respondeu à minha pergunta As instruções do artigo não funcionaram para mim Achei este artigo confuso e difícil de ler Outro

Please enter feedback before submitting.

Agradecemos sua opinião!