Criar uma chave de API e o primeiro envelope

Uma chave do time, um POST com o PDF e os dados do seu cliente, e um link de assinatura por signatário.


  1. 1

    Um dono ou gestor abre Developers, dá nome a uma chave (por exemplo "Website") e toca em Create key. Copie na hora — ela começa com es_live_ e aparece só uma vez.

  2. 2

    Envie POST https://api.socialdna.app/api/esign/v1/envelopes com Authorization: Bearer es_live_… (ou X-Api-Key) e um corpo JSON: title, document (base64 ou uma url https), signers (nome, e-mail, telefone, channel: email, whatsapp, sms, call ou link, e valores prefill) e, se quiser, fields, message, order, expires_days e ext_ref.

  3. 3

    A resposta traz o envelope e um signing_url para cada signatário. Use deliver: false para receber os links sem enviar nada, ou send: false para guardar um rascunho.

  4. 4

    Leia envelopes com GET /v1/envelopes e GET /v1/envelopes/{id}, baixe o PDF com GET /v1/envelopes/{id}/document, envie um rascunho com POST /v1/envelopes/{id}/send, anule com POST /v1/envelopes/{id}/void e confira o uso com GET /v1/account.

Dica: Guarde as chaves no seu servidor, nunca numa página web. Revogue uma chave em Developers e os apps que a usam param na hora.

Ainda precisa de ajuda?

A nossa equipe responde por chamado e e-mail.