Listar Grupos de Assinaturas (API)
Este endpoint da API D4Sign permite que você liste todos os grupos de assinatura configurados dentro de um cofre específico. É útil para gerenciar e organizar os conjuntos de signatários que você utiliza em seus documentos.
🚧 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/groups/{UUID-SAFE}?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.
{
"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-SAFE
é enviado na URL para identificar o cofre cujos grupos você deseja listar.
Resposta (Status 200 - Sucesso)
Quando a requisição for bem-sucedida, você receberá um objeto JSON contendo os detalhes do grupo de assinatura. Note que a resposta no exemplo parece ser de um único grupo, mas o método lista "todos os grupos". Dependendo da implementação, pode ser um array de objetos. Assumindo a estrutura do exemplo, é um objeto único.
{
"uuid_grupo": "018715xc-054b-409f-b122-f683951e5460",
"nome": "Grupo Jurídico"
}
Detalhes dos Campos da Resposta:
Campo | Tipo | Descrição |
uuid_grupo |
String | O UUID (identificador único) do grupo de assinatura. |
nome |
String | O nome do grupo de assinatura. |