API
Criar sessão de validação de envelope
Cria uma sessão pública para consultar um envelope assinado por código + senha.
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/signaturePasswordnã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
- Use o
sessionUuidretornado emGET /signer/v1/validator/session/:sessionUuidpara recuperar os dados completos do envelope (envelope, signatários, link de download do documento assinado). - Se precisar cancelar a sessão antes de expirar, chame
POST /signer/v1/validator/session/:sessionUuid/cancel.