Ontwikkelaars · API · Webhooks

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 software

Eerste 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.
Een API-sleutel in elk plan

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. 1. Meld je gratis aan.
  2. 2. Open Instellingen → API en zet Ontwikkelaarsinstellingen aan.
  3. 3. Instellingen → API → API-sleutel aanmaken.
  4. 4. Roep GET /v1/me aan met de sleutel. Er wordt niets verstuurd en je ziet dat de sleutel werkt.
Wat je krijgt

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-overzicht

Ondertekende 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-events

Documentatie 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 hem

Concrete 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_reuse
Recepten

Wat je vandaag kunt bouwen.

Elk patroon gebruikt de REST API en webhooks. De kaarten linken naar de documentatie die het beschrijft.

Nog 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.