Listar Respostas do Novo Power Form (API)
Este endpoint da API D4Sign permite que você recupere as respostas coletadas por um Power Form específico. É uma forma eficaz de acessar os dados preenchidos pelos seus usuários e integrá-los aos seus sistemas.
🚧 Importante: Não esqueça de enviar o tokenAPI e cryptKey em sua requisição.
Exemplo de URL completa para requisição: https://secure.d4sign.com.br/api/v1/documents/{uuid_documento}/powerformresponses?tokenAPI={SEU-TOKEN}&cryptKey={SEU-CRYPT-KEY}
Header
O cabeçalho da sua requisição deve conter o Content-Type
como application/json
, além dos seus tokens de autenticação.
JSON
{
"Content-Type": "application/json",
"tokenAPI": "{SEU-TOKEN-API}",
"cryptKey": "{SUA-CRYPT-KEY}"
}
Body
Para este endpoint, o corpo da requisição não é necessário. O UUID-DOCUMENTO
é enviado na URL para identificar o Power Form cujas respostas você deseja listar.
Resposta (Status 200 - Sucesso)
Quando a requisição for bem-sucedida, você receberá um objeto JSON contendo os detalhes do documento e um array com as respostas de cada preenchimento do Power Form.
JSON
{
"uuid_documento_gerado": "abcd-efgh-ijkl-123456789123",
"nome_documento": "Documento Teste",
"respostas": [
{
"email_preenchedor": "e-mail do preenchedor 1",
"dt_cadastro": "2025-03-24 17:04:10",
"campos_respostas": {
"toke1": "Resposta1",
"token2": "Resposta2"
}
},
{
"whatsapp_preenchedor": "whatsapp do preenchedor 2",
"dt_cadastro": "2025-03-24 17:03:37",
"campos_respostas": {
"CPF": "12345678900",
"Cidade": "Cidade A",
"Plano": "Plano A"
}
}
]
}
Detalhes dos Campos da Resposta:
Campo | Tipo | Descrição |
uuid_documento_gerado |
String | O UUID do documento principal do Power Form. |
nome_documento |
String | O nome do documento principal do Power Form. |
respostas |
Array | Um array de objetos, onde cada objeto representa um preenchimento completo do Power Form. |
email_preenchedor |
String | O e-mail do usuário que preencheu o formulário, se fornecido. |
whatsapp_preenchedor |
String | O WhatsApp do usuário que preencheu o formulário, se fornecido. |
dt_cadastro |
String | A data e hora em que a resposta foi registrada. |
campos_respostas |
Objeto | Um objeto JSON contendo as respostas para cada campo do Power Form. As chaves são os nomes dos campos (tokens) e os valores são as respostas preenchidas. |