Copiar Link de Assinatura (API)
Este endpoint da API D4Sign permite que você obtenha o link de assinatura exclusivo para um signatário específico de um determinado documento. Isso é útil para direcionar signatários diretamente para a página de assinatura ou para integrá-lo em fluxos de comunicação personalizados.
Exemplo de URL completa para requisição:
https://secure.d4sign.com.br/api/v1/documents/{UUID-DOCUMENTO}/signaturelink/{ID_LINKASSINATURA}?tokenAPI={SEU-TOKEN}&cryptKey={SEU-CRYPT-KEY}
Header
O cabeçalho da sua requisição deve conter o Content-Type como application/json
.
{
"Content-Type": "application/json"
}
Body
Para este endpoint, o corpo da requisição não é necessário. Os UUID do documento e o ID do link de assinatura são enviados na URL.
Resposta (Status 200 - Sucesso)
Quando a requisição for bem-sucedida, você receberá um objeto JSON contendo o link de assinatura.
{
"link": "https://sandbox.d4sign.com.br/w/i/{uuid-documento}/xxxxxxxxxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx/xxxx"
}
Detalhes dos Parâmetros da Requisição (URL):
Parâmetro | Tipo | Obrigatóriodade | Descrição |
UUID-DOCUMENTO |
String | Obrigatório | O UUID (identificador único) do documento. |
ID_LINKASSINATURA |
String | Obrigatório | O ID do link de assinatura do signatário (que é a key-signer decodificada em Base64). |
🚧 Observações Importantes:
-
Disponibilidade do Link: O link de assinatura só estará disponível após o documento ter sido enviado para o signatário. Se a requisição for feita em uma fase onde o link ainda não existe, será retornado um erro.
-
Permissões Necessárias: Apenas usuários com as seguintes permissões podem realizar a consulta:
-
Dono do cofre.
-
Permissão de Administrador, caso o cofre seja compartilhado.
-
Permissão Padrão, caso o cofre seja compartilhado.
-