Pular para o conteúdo
API REST

API de assinatura eletrônica liberada desde o plano grátis

Seu sistema envia o documento, pede a assinatura e é notificado por webhook quando cada pessoa assina.

pedir-assinatura.sh
# Pede a assinatura e recebe o link de cada signatário
curl -X POST \
  https://sandbox.assinafy.com.br/v1/documents/{document_id}/assignments \
  -H 'X-Api-Key: {api_key}' \
  -H 'Content-Type: application/json' \
  -d '{"method":"virtual","signers":[{"id":"{signer_id}"}]}'

# Resposta: um link de assinatura por signatário
{ "signing_urls": [
  { "signer_id": "{signer_id}",
    "url": "…/v1/sign/…" }
] }
200 Solicitação criada
Sem custo por chamadaA franquia conta documentos, não requisições.
Aviso a cada etapaSeu sistema recebe por webhook o convite, a abertura, a assinatura e o PDF pronto.
Mesma validade jurídicaO documento sai com a página de certificação e a trilha de auditoria.
Recursos da API

Do upload ao documento assinado, tudo pela API

Cada recurso tem a referência completa na documentação.

Documentos e modelos

Envie o PDF ou gere o documento a partir de um modelo salvo, com campos e papéis.

Ver na documentação ↗

Custo antes do envio

Consulte quanto o envio vai consumir da franquia e dos créditos antes de disparar.

Ver na documentação ↗
Webhooks verificados

Seu sistema é notificado na hora em que o documento é assinado

Com a verificação ativada, seu sistema descarta o que não vier da Assinafy.

  • Assinatura HMAC-SHA256 no padrão aberto Standard Webhooks, que você ativa em cada webhook
  • O mesmo webhook-id em toda tentativa, para descartar evento repetido
  • Um webhook no plano grátis e até três nos planos pagos, cada um com seus eventos
Ver como verificar ↗
POST /seu-sistema/webhooksOrigem conferida
  1. Convite enviadosignature_requested
  2. Documento abertosigner_viewed_document
  3. Signatário assinousigner_signed_document
  4. PDF prontodocument_ready
2xxO último signatário assinou e o PDF está pronto.
Também chegam a recusa e a falha de processamento.Ver todos os eventos ↗
Para software houses

Leve a assinatura para os clientes do seu sistema

SDKs de servidor, SDKs mobile e OAuth para cada cliente conectar o próprio workspace.

TypeScript
# Instalação
npm install @assinafy/sdk

# Uso
import { AssinafyClient } from '@assinafy/sdk';

const client = new AssinafyClient({
  apiKey: process.env.ASSINAFY_API_KEY!,
  accountId: process.env.ASSINAFY_ACCOUNT_ID!,
});

const resultado = await client.uploadAndRequestSignatures({
  source: { filePath: './contrato.pdf' },
  signers: [
    { name: 'João Silva', email: 'joao@exemplo.com.br' },
  ],
  message: 'Por favor, assine este contrato',
});

SDKs de servidor

TypeScript, Python, Ruby, Go, Rust, .NET, Java, PHP e Object Pascal, sobre a mesma API.

Ver os SDKs

Apps iOS e Android

SDKs nativos para celular. A chave fica no seu servidor e o app usa um token de curta duração.

Ver os SDKs mobile

OAuth para os seus clientes

Cada cliente conecta o próprio workspace da Assinafy ao seu produto, sem entregar a chave de API.

Ver o guia de OAuth ↗

Antes de programar, veja se a integração já existe

HubSpot, Google Docs, Word, Zapier, Make, n8n e outras ferramentas já se conectam à Assinafy. Use a API para o que é só do seu sistema.

Ver todas as integrações

Não achou sua ferramenta? Peça aqui

Ver todas as integrações

Não achou sua ferramenta? Peça aqui

Clientes

Empresas que já enviam documentos pela Assinafy

Integração pela API, assinatura sem atrito para o cliente e contratação a distância.

5,0 de 5 estrelasnas avaliações do Google
“Quanto menos fricção a gente tiver para o nosso cliente assinar o documento, melhor vai ser. A gente hoje não vê assinatura como uma barreira.”
Assistir ao depoimento em vídeo
Renato CarradoreCEO · Inovar Sistemas
Avaliação no Google
“Nossa experiência com a Assinafy tem sido excelente! A facilidade de integração pela API nos permitiu automatizar as etapas da gestão dos nossos contratos. Um ponto que realmente impressiona é que, desde que começamos a usar a plataforma, não tivemos nenhum problema com seu funcionamento.”
Azeen Contabilidade Online
Consolide Sua Marca
“A gente precisou contratar pessoas em outras cidades, e a Assinafy trouxe para a gente essa agilidade nas contratações.”
Assistir ao depoimento em vídeo
Caroline Oriques de PráCoordenadora de RH · Consolide Sua Marca
Avaliação no Google
“Utilizamos a Assinafy internamente para assinatura de todos os contratos e documentos da companhia. Nunca tivemos problemas. A plataforma é ágil, intuitiva, organizada, segura e confiável.”
Thayna S.Analista de RH · homeyou
“O processo de integração foi excelente. Eu costumo dizer que a Assinafy foi talvez uma das melhores prestadoras de serviço que a gente já teve no Simples Dental nos últimos anos.”
Assistir ao depoimento em vídeo
Ramon MacielCEO · Simples Dental
Avaliação no Google
“A Assinafy facilita muito minha rotina! Gosto da praticidade da plataforma e de como é simples resolver tudo por lá. Minha experiência tem sido ótima e recomendo com certeza!”
Cida F.

Perguntas sobre a API de assinatura eletrônica

O que perguntam antes de integrar.

Da chave de API à primeira assinatura

Crie a conta, gere a chave e teste no sandbox.