Skip to main content
POST
Criar sessão de validação de envelope
Cria uma sessão de validação de envelope usando apenas um código de assinatura e uma senha. As sessões de validação permitem que qualquer pessoa (sem chave de API ou token) consulte e valide um envelope assinado, desde que possua o código e a senha. Cada sessão de validação é válida por 15 minutos. Esta operação é idempotente: chamar múltiplas vezes com os mesmos signatureCode e signaturePassword enquanto a sessão anterior ainda estiver válida retorna a mesma sessionUuid. Autenticação: este endpoint é público — nenhuma autenticação é necessária.

Parâmetros

string
required
Código de assinatura do signatário a validar. Tipicamente fornecido ao signatário via e-mail ou outro canal após a assinatura.
string
required
Senha de assinatura do signatário a validar. Fornecida junto com o código.

Respostas

string
required
UUID da sessão de validação criada (ou reutilizada). Use este UUID em GET /signer/v1/validator/session/:sessionUuid para recuperar os dados do envelope.

Erros

  • 404: O envelope ou o signatário associado ao signatureCode/signaturePassword não foi encontrado.

Exemplo

Importante

  • Sem autenticação: este endpoint é totalmente público — qualquer pessoa com o código e a senha pode criar uma sessão.
  • Idempotente: enquanto a sessão anterior estiver válida (TTL de 15 min), chamadas repetidas retornam o mesmo sessionUuid.
  • TTL de 15 minutos: a sessão expira após 15 minutos. Crie uma nova se precisar consultar novamente após expiração.
  • IP registrado: o IP da requisição é registrado para auditoria.

Próximas etapas

  1. Use o sessionUuid retornado em GET /signer/v1/validator/session/:sessionUuid para recuperar os dados completos do envelope (envelope, signatários, link de download do documento assinado).
  2. Se precisar cancelar a sessão antes de expirar, chame POST /signer/v1/validator/session/:sessionUuid/cancel.