Assinar em lote via API

Assinar em lote via API

POST https://api.zapsign.com.br/api/v1/sign/

Caso alguém da sua empresa tenha sempre que assinar muitos documentos na ZapSign, uma opção é realizar essa assinatura programaticamente via API. Pré-requisitos: 1. você só pode assinar via API com usuários da sua conta, adicionados nas Configurações. Ou seja, não é possível assinar programaticamente para terceiros ou clientes externos que não sejam usuários na sua conta; 2. assinar via API não consome créditos (é gratuito), mas é necessário possuir um Plano de API ativo para conseguir utilizar este endpoint, inclusive com documentos sandbox/testes.

3. A assinatura em lote funciona apenas para documentos que contenham "assinatura na tela" como único método de autenticação. Estamos trabalhando para viabilizar a assinatura em lote de documentos com as demais autenticações também!

Headers

Request Body

Exemplo de requisição

Exemplo de response (bem sucedida)

{"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."}

Como conseguir o user_token?

Faça login no usuário que irá assinar os documentos e entre em seu perfil:

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 updated