Una chiamata invia il contratto.Sai subito quando è firmato.
Un'API REST per inviare PDF da firmare e seguire ogni firmatario, webhook firmati per ogni passaggio, chiavi di idempotenza e codici di errore stabili. Una chiave API e i webhook in ogni piano: Free 10 documenti al mese, Branded 100 tramite l'API, Enterprise senza limite.
Cosa puoi costruire: firme dal tuo softwarePrima chiamata: verifica la chiave. Non invia nulla.
# Paste the full key — the dashboard only shows its prefix
export WESIGN_API_KEY="wsk_live_…"
# Sends nothing: checks the key and names its workspace
curl https://api.wesign.now/v1/me \
-H "Authorization: Bearer $WESIGN_API_KEY"
# 200 → { "workspace": { … }, "key": { … }, "capabilities": { … }, … }Poi invia un PDF a due firmatari.
# Paste the full key — the dashboard only shows its prefix
export WESIGN_API_KEY="wsk_live_…"
curl -X POST https://api.wesign.now/v1/signing-requests \
-H "Authorization: Bearer $WESIGN_API_KEY" \
-H "Idempotency-Key: quickstart-$(date +%s)" \
-F "file=@contract.pdf" \
-F "placement=auto_append" \
-F 'signers=[
{ "email": "anna.muster@example.com",
"name": "Anna Muster", "role": "counterparty" },
{ "email": "you@example.com",
"name": "Your name", "role": "company" }
]'
# 201 → { "documentId": "…", "signers": [
# { "role": "counterparty", "signingUrl": "…", "emailed": true },
# { "role": "company", "signingUrl": "…", "emailed": true } ] }
# Every answer carries an X-Request-Id header: quote it to
# support@wesign.now when something is off.Ottieni la tua chiave API
- Free: 10 documenti al mese, il limite del piano
- Branded: 100 documenti al mese tramite l'API
- Enterprise: nessun limite
- 1. Registrati gratis.
- 2. Apri Impostazioni → API e attiva Impostazioni sviluppatore.
- 3. Impostazioni → API → Crea chiave API.
- 4. Chiama
GET /v1/mecon la chiave. Non invia nulla e mostra che la chiave funziona.
Un'API, webhook e una documentazione che anche i tuoi strumenti sanno leggere.
API REST
Invia un PDF, segui ogni firmatario, invia un promemoria o ritira la richiesta, scarica il PDF sigillato e il suo audit trail. Chiavi Bearer, risposte JSON e una specifica OpenAPI 3.1 con un id per ogni operazione.
Panoramica dell'APIWebhook firmati
signing_request.sent, .viewed, .signed, document.completed e altri, ognuno firmato con HMAC-SHA256. Una consegna non riuscita viene ritentata per circa 45 ore; dal registro delle consegne puoi inviarla di nuovo.
Eventi webhookDocumentazione per assistenti IA
llms.txt elenca ogni pagina della documentazione, llms-full.txt le contiene tutte in testo semplice, openapi.json la forma esatta di richieste e risposte. Dalli al tuo assistente di programmazione.
Per gli assistenti IAServer MCP: invia e segui dal tuo agenteUsi un agente? Scopri come collegarloEsempi concreti.
Quattro chiamate che servono alla maggior parte delle integrazioni. Nomi dei campi come nella specifica OpenAPI.
1. Invio con posizionamento ad ancora
Inserisci nel PDF un marcatore come [[ls:signature:buyer]]. Lì posizioniamo il campo firma dell'acquirente e nascondiamo il marcatore. Nessun marcatore nel PDF? Aggiungiamo una pagina di firma.
# offer.pdf contains the text [[ls:signature:buyer]]
curl https://api.wesign.now/v1/signing-requests \
-H "Authorization: Bearer $WESIGN_API_KEY" \
-H "Idempotency-Key: offer-2041/sign" \
-F "file=@offer.pdf" \
-F "placement=anchors" \
-F 'signers=[{"email":"buyer@acme.com","role":"buyer","name":"Ann Buyer"}]'2. Più firmatari, in ordine
Tre firmatari, uno dopo l'altro. Il firmatario 2 viene invitato solo dopo che il firmatario 1 ha firmato.
curl https://api.wesign.now/v1/signing-requests \
-H "Authorization: Bearer $WESIGN_API_KEY" \
-H "Idempotency-Key: round-a/sign" \
-F "file=@contract.pdf" \
-F "signing_mode=sequential" \
-F "placement=auto_append" \
-F 'signers=[
{"email":"founder@acme.com","role":"founder"},
{"email":"investor@vc.example","role":"investor"},
{"email":"witness@law.example","role":"witness"}
]'3. Ricevitore di webhook
Controlla il timestamp e l'HMAC sul corpo grezzo, poi gestisci l'evento.
// Node + Express. The full verifier (Node and PHP) is in the docs.
app.post('/wesign/callback', express.raw({ type: 'application/json' }), (req, res) => {
// X-WeSign-Signature: t=<unix seconds>,v1=<hex> (two v1 for 24 h after a rotation)
const parts = (req.get('x-wesign-signature') ?? '').split(',')
const t = parts[0]?.startsWith('t=') ? parts[0].slice(2) : ''
if (!t || Math.abs(Date.now() / 1000 - Number(t)) > 300) return res.status(401).end()
const expected = crypto.createHmac('sha256', SECRET)
.update(`${t}.${req.body}`).digest()
const valid = parts.filter((p) => p.startsWith('v1=')).some((p) => {
const got = Buffer.from(p.slice(3), 'hex')
return got.length === expected.length && crypto.timingSafeEqual(got, expected)
})
if (!valid) return res.status(401).end()
const evt = JSON.parse(req.body.toString('utf8'))
if (evt.event === 'document.completed') {
// fetch evt.signed_pdf_url with your API key, compare evt.sha256, keep a copy
}
res.sendStatus(200)
})4. Nuovo tentativo idempotente
La stessa chiave con lo stesso corpo entro 24 ore restituisce di nuovo la prima risposta: un nuovo tentativo dopo un errore di rete non invia mai due volte.
POST /v1/signing-requests
Idempotency-Key: order-123/sign
# First call: 201 Created
# Same key + same body (24 h): 201, the same body, Idempotent-Replayed: true
# Same key while the first runs: 409 idempotency_in_progress + Retry-After
# Same key + a different body: 422 idempotency_key_reuseCosa puoi costruire oggi.
Ogni schema usa l'API REST e i webhook. Le schede rimandano alla documentazione che lo descrive.
Con send_emails: false non inviamo alcun invito via e-mail, e il link di ogni firmatario torna nella risposta per la tua e-mail, il tuo SMS o la tua app. I promemoria e l'e-mail di completamento partono comunque da noi.
send_emailsIl loro passaggio HTTP chiama l'API con la tua chiave e il loro passaggio webhook riceve i nostri eventi, una volta registrato con POST /v1/hooks. Niente da installare.
Hook per strumenti di automazioneIl tuo handler riceve il cambio di fase dal CRM, invia il contratto e aggiorna il record quando il nostro webhook segnala la firma. L'handler lo gestisci tu; non esiste un'app CRM.
Ricetta CRMDocassemble, Pandoc o LaTeX scrive i marcatori d'ancora nel PDF, un POST lo invia e scarichi il PDF firmato all'arrivo di document.completed.
Ricetta generatoreFai scrivere all'agente marcatori come [[ls:signature:client]] nella bozza: i campi finiscono lì. Ogni firma resta di una persona che apre il proprio link.
Ricetta agenteCrea sul tuo server una sessione di breve durata e mostra la vista di firma in un iframe sul tuo sito. I tuoi firmatari non hanno bisogno di un account.
Firma integrataNon ancora disponibili: un SDK, una sandbox con chiavi di test (prevista per il 30 novembre), app o plug-in per altri strumenti.
Pensato per la produzione.
Chiavi Bearer, due ambiti
Ogni chiave appartiene a un solo workspace. Una chiave full chiama tutta l'API; una chiave embedded gestisce solo le sessioni di firma integrata. Limita una chiave ai tuoi indirizzi IP; una revoca ha effetto subito.
60 richieste al minuto per chiave
Una finestra fissa per chiave su tutti gli endpoint /v1. Le risposte riuscite hanno gli header RateLimit-*; una 429 ha Retry-After.
Codici di errore stabili
Ogni errore è un JSON con un messaggio leggibile (error), un code stabile e, dove serve, meta. Controlla il code; il messaggio può cambiare.
PDF sigillati e verificabili
Il PDF firmato porta un sigillo PAdES che qualsiasi lettore conforme può verificare. L'audit trail elenca ogni evento con l'orario, l'e-mail e l'indirizzo IP mascherato del firmatario e ogni verifica con codice SMS.
Ottieni la tua chiave API e invia oggi il tuo primo contratto.
Registrati gratis, attiva le impostazioni sviluppatore e crea una chiave. Enterprise aggiunge documenti API illimitati, la firma integrata e l'invio di modelli tramite l'API: parlane con noi. La documentazione è pubblica: puoi leggerla prima.