API RESTful e webhooks assinados
Integre o MySign ao seu ERP, CRM ou portal e deixe a assinatura dentro do seu produto.
Ida e volta: você cria, o MySign avisa
O seu sistema cria o documento e cadastra os signatários por uma chamada; o MySign devolve cada evento por webhook, com assinatura para validar a origem.
- Autenticação por token com escopo
- Webhooks para cada mudança de status
- Ambiente de sandbox para homologar
Quatro passos até produção
- 01
Token com escopo
Gere uma chave no painel, limitada às ações que o seu sistema precisa.
- 02
Crie o documento
Um POST com o PDF, os signatários e o nível de cada um. A resposta traz o id e o status.
- 03
Receba os eventos
Cada mudança de status chega no seu endpoint, assinada para você validar a origem.
- 04
Homologue no sandbox
Teste o fluxo inteiro sem gastar documentos reais; depois troque a chave e publique.
Um documento em uma chamada
PDF, signatários e nível de cada um numa requisição. A resposta traz o id do documento e o status inicial; o resto chega por webhook.
- JSON simples, sem SDK obrigatório
- Níveis por signatário na mesma chamada
- Webhook por documento ou global
POST /api/v1/documents
{
"name": "Contrato de prestação",
"file": "<base64>",
"signers": [
{ "name": "Maria", "email": "maria@acme.com", "level": "advanced" }
],
"webhook": "https://acme.com/mysign/events"
}
201 { "id": "doc_8f2c", "status": "waiting" }Os eventos que chegam no seu endpoint
document.created
O documento foi criado e está aguardando envio ou assinaturas.
signer.opened
Um signatário abriu o link do documento.
signer.signed
Um signatário assinou; o evento traz o nível e o horário.
document.completed
Todos assinaram; o PDF final com certificado está disponível.