ZapSign API
Search…
Assinar em lote via API
post
https://api.zapsign.com.br
/api/v1/sign/?api_token={{seu_token_de_acesso}}
Assinar em lote via API

Exemplo de requisição

1
{
2
"user_token": "23d4d2d5-8998-4516-b2f8-6045c4eabc9d", //token do usuário que irá assinar
3
"signer_tokens":[
4
"3c8f16f8-949b-432a-adea-d1e544bb91be", //token de signatário do primeiro documento
5
"fed91ab3-bb69-46f9-8c2d-9594772b1186" //token de signatário do segundo documento
6
]
7
}
Copied!

Exemplo de response (bem sucedida)

1
{"message":"Documento(s) assinado(s) com sucesso. Lembrete: este endpoint é assíncrono, então aguarde os PDF finais ficarem prontos via webhooks ou confira-os daqui alguns minutos."}
Copied!

Como conseguir o user_token?

Faça login no usuário que irá assinar os documentos e entre em seu perfil:
Perfil do usuário.
No final da página, habilite a assinatura via API e copie o token.

Como conseguir os signer_tokens?

Todo signatário (signer) criado na ZapSign possui um token. Basta copiar esse token gerado pela ZapSign após um documento ser criado ou depois de você adicionar um signatário. (Atenção: não é o token do documento, e sim o token do signatário!)
Obs: se deseja assinar apenas um documento por vez, basta inserir um array com apenas um token do signer. Ex: signer_tokens: ["123-abc-456-def"]

Erros 404

Caso você tente realizar uma requisição com user_token ou signer_tokens que não existam, você receberá uma response 404 (não encontrado). Caso isso ocorra, veja com atenção se você está usando de fato o token do signatário em vez do token do documento, e se não está invertendo com o user_token, etc.

Endpoint Assíncrono

Este endpoint é assíncrono, isto é, você irá pedir a assinatura dos documentos e receberá uma resposta quase imediata da ZapSign. Conforme os documentos forem ficando prontos, você irá receber os webhooks em sua aplicação um por vez.
Evite assinar mais do que 100 documentos de uma vez só para evitar lentidão. Faça mais de uma requisição se o caso.
Last modified 1mo ago