Listar Assinaturas Posicionadas ao Documento (API)
Esta seção da API D4Sign permite que você visualize todas as assinaturas, rubricas ou selos que foram previamente posicionados em um documento. Isso é útil para verificar o layout ou as configurações de posicionamento antes ou depois das assinaturas.
🚧 Importante: Não esqueça de enviar o tokenAPI
e cryptKey
em sua requisição.
Exemplo: https://secure.d4sign.com.br/api/v1/documents/{UUID-DOCUMENT}/listpins?tokenAPI={SEU-TOKEN}&cryptKey={SEU-CRYPT-KEY}
Este endpoint irá listar todos os "pins" (assinaturas, rubricas e selos) e suas respectivas posições em um documento específico.
GET /documents/{UUID-DOCUMENT}/listpins
Parâmetros de Requisição (URL)
Parâmetro |
Descrição |
|
(obrigatório) O UUID do documento cujas assinaturas posicionadas você deseja listar. |
{
"Accept": "application/json"
}
Resposta
Em caso de sucesso, a resposta retornará um objeto JSON contendo um array de pins, cada um com suas informações de posicionamento e o e-mail do signatário.
{
"pins": [
{
"page_height": "300",
"page_width": "500",
"pagina": "1",
"position_x": "1",
"position_y": "1",
"email": "email@email.com"
},
{
"page_height": "300",
"page_width": "500",
"pagina": "2",
"position_x": "150",
"position_y": "200",
"email": "outro.email@dominio.com"
}
]
}
Campo |
Descrição |
|
Um array de objetos, onde cada objeto representa um pin posicionado. |
|
Altura da página onde o pin está localizado em pixels. |
|
Largura da página onde o pin está localizado em pixels. |
|
O número da página onde o pin está posicionado. |
|
Posição X (horizontal) do pin em pixels, a partir da esquerda da página. |
|
Posição Y (vertical) do pin em pixels, a partir do topo da página. |
|
E-mail do signatário associado ao pin. |