Eén aanroep verstuurt het contract.Je weet het zodra het ondertekend is.
Een REST API om pdf's ter ondertekening te versturen en elke ondertekenaar te volgen, ondertekende webhooks voor elke stap, idempotentiesleutels en stabiele foutcodes. Een API-sleutel en webhooks in elk plan: Free 10 documenten per maand, Branded 100 via de API, Enterprise zonder limiet.
Wat je kunt bouwen: handtekeningen vanuit je eigen softwareEerste aanroep: controleer de sleutel. Er wordt niets verstuurd.
# 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": { … }, … }Stuur daarna een pdf naar twee ondertekenaars.
# 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.Zo krijg je je API-sleutel
- Free: 10 documenten per maand, de limiet van het plan
- Branded: 100 documenten per maand via de API
- Enterprise: geen limiet
- 1. Meld je gratis aan.
- 2. Open Instellingen → API en zet Ontwikkelaarsinstellingen aan.
- 3. Instellingen → API → API-sleutel aanmaken.
- 4. Roep
GET /v1/meaan met de sleutel. Er wordt niets verstuurd en je ziet dat de sleutel werkt.
Een API, webhooks en documentatie die ook je tools kunnen lezen.
REST API
Verstuur een pdf, volg elke ondertekenaar, stuur een herinnering of trek het verzoek in, en download de verzegelde pdf en de audittrail. Bearer-sleutels, JSON-antwoorden en een OpenAPI 3.1-specificatie met een id voor elke operatie.
API-overzichtOndertekende webhooks
signing_request.sent, .viewed, .signed, document.completed en meer, elk ondertekend met HMAC-SHA256. Een mislukte levering proberen we ongeveer 45 uur lang opnieuw; via het leveringslog kun je hem opnieuw versturen.
Webhook-eventsDocumentatie voor AI-assistenten
llms.txt somt elke documentatiepagina op, llms-full.txt bevat ze allemaal als platte tekst, openapi.json de exacte vorm van verzoeken en antwoorden. Geef ze aan je codeerassistent.
Voor AI-assistentenMCP-server: verstuur en volg vanuit je agentWerk je met een agent? Zo verbind je hemConcrete voorbeelden.
Vier calls die de meeste integraties nodig hebben. Veldnamen zoals in de OpenAPI-specificatie.
1. Versturen met ankerplaatsing
Zet een marker zoals [[ls:signature:buyer]] in je pdf. Wij plaatsen daar het handtekeningveld van de koper en verbergen de marker. Geen marker in de pdf? Dan voegen we een handtekeningpagina toe.
# 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. Meerdere ondertekenaars, op volgorde
Drie ondertekenaars, na elkaar. Ondertekenaar 2 wordt pas uitgenodigd als ondertekenaar 1 heeft getekend.
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. Webhook-ontvanger
Controleer de tijdstempel en de HMAC over de ruwe body en handel dan het event af.
// 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. Idempotente herhaling
Dezelfde sleutel met dezelfde body binnen 24 uur geeft het eerste antwoord opnieuw, dus een herhaling na een netwerkfout verstuurt nooit dubbel.
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_reuseWat je vandaag kunt bouwen.
Elk patroon gebruikt de REST API en webhooks. De kaarten linken naar de documentatie die het beschrijft.
Met send_emails: false mailen we geen uitnodiging, en de link van elke ondertekenaar komt terug in het antwoord voor je eigen e-mail, sms of app. Herinneringen en de afrondingsmail komen nog wel van ons.
send_emailsHun HTTP-stap roept de API aan met je sleutel, en hun webhookstap ontvangt onze events zodra je hem registreert met POST /v1/hooks. Niets te installeren.
Hooks voor automatiseringstoolsJe handler ontvangt de fasewijziging uit het CRM, verstuurt het contract en werkt het record bij zodra onze webhook de handtekening meldt. De handler draai je zelf; er is geen CRM-app.
CRM-receptDocassemble, Pandoc of LaTeX schrijft ankermarkers in de pdf, één POST verstuurt hem, en je haalt de ondertekende pdf op zodra document.completed binnenkomt.
Generator-receptLaat de agent markers zoals [[ls:signature:client]] in het concept schrijven: daar komen de velden. Elke handtekening wordt nog steeds gezet door een mens die zijn link opent.
Agent-receptMaak op je server een kortlevende sessie aan en toon de ondertekenweergave in een iframe op je eigen site. Je ondertekenaars hebben geen account nodig.
Ingebedde ondertekeningNog niet beschikbaar: een SDK, een sandbox met testsleutels (gepland voor 30 november), en apps of plug-ins voor andere tools.
Gebouwd voor productie.
Bearer-sleutels, twee scopes
Elke sleutel hoort bij één workspace. Een full-sleutel roept de hele API aan; een embedded-sleutel beheert alleen ingebedde ondertekensessies. Beperk een sleutel tot je IP-adressen; intrekken werkt meteen.
60 verzoeken per minuut per sleutel
Eén vast venster per sleutel over alle /v1-endpoints. Geslaagde antwoorden hebben RateLimit-*-headers; een 429 heeft Retry-After.
Stabiele foutcodes
Elke fout is JSON met een leesbare melding (error), een stabiele code en, waar het helpt, meta. Vergelijk op code; de melding kan veranderen.
Verzegelde, controleerbare pdf's
De ondertekende pdf draagt een PAdES-zegel dat elke conforme reader kan controleren. De audittrail toont elk event met tijdstip, het e-mailadres en het gemaskeerde IP-adres van de ondertekenaar en elke sms-codecontrole.
Haal je API-sleutel en verstuur vandaag je eerste contract.
Meld je gratis aan, zet de developer-instellingen aan en maak een sleutel aan. Enterprise voegt onbeperkte API-documenten, ingebed ondertekenen en sjablonen verzenden via de API toe: praat met ons. De documentatie is openbaar, dus je kunt hem eerst lezen.