AssinAPI

SDK e CLI

SDK JavaScript / TypeScript

bash
npm install @assinapi/sdk
typescript
import { AssinAPI } from '@assinapi/sdk';

const assinapi = new AssinAPI({ apiKey: process.env.ASSINAPI_SECRET_KEY });

const envelope = await assinapi.envelopes.create({ title: 'Contrato' });
await assinapi.envelopes.addDocument(envelope.id, { file: pdfBuffer, filename: 'contrato.pdf' });
await assinapi.envelopes.addSigner(envelope.id, { name: 'João', email: 'joao@email.com', cpf: '529.982.247-25' });
const sent = await assinapi.envelopes.send(envelope.id);
  • SDK fino sobre a REST — nenhuma regra jurídica fica só no cliente.
  • POSTs enviam Idempotency-Key automática; retries reutilizam a mesma chave.
  • Recusa-se a rodar no navegador (proteção da secret key).
  • Em breve: @assinapi/node, assinapi-python, assinapi-php.

CLI

bash
npm install -g @assinapi/cli

assinapi login --token ask_test_…        # ou um PAT asp_… para projetos/chaves/logs
assinapi projects
assinapi keys create --name "Backend" --env SANDBOX
assinapi listen --forward-to localhost:3000/api/webhooks/assinapi
assinapi trigger envelope.completed
assinapi logs --errors
assinapi verify contrato-assinado.pdf