Voor ontwikkelaars

Ondertekenen, verzegelen en controleren vanuit uw eigen software Beta

Eén aanroep verzegelt een pdf. Nog één stuurt hem ter ondertekening. Iedereen kan het resultaat controleren op verify.onwyn.io. Gemaakt voor leveranciers van ERP- en bedrijfssoftware die ondertekenen in hun eigen product willen hebben.

Vraag een API-sleutel aan Bekijk de aanroepen Een document controleren

Tijdens de bèta geeft Onwyn elke API-sleutel met de hand uit. Geef ons de exacte juridische naam van uw bedrijf: die staat op elk zegel.

Uw eerste zegel in drie stappen

  1. Vraag een sleutel aan

    Bewaar hem op uw server, in een omgevingsvariabele. Zet hem nooit in een browser of een app.

    export ONWYN_API_KEY='onwyn_test_XXXXXXXX'
  2. Verzegel een pdf

    De verzegelde pdf komt in dezelfde aanroep terug. De header X-Onwyn-Code bevat de code.

    curl -sS --max-time 120 -D - -o sealed.pdf \
      -H "Authorization: Bearer $ONWYN_API_KEY" \
      -F file=@invoice.pdf -F ref=INV-2026-0001 \
      https://sign.onwyn.io/api/seal
  3. Controleer het

    De controle is openbaar en heeft geen sleutel nodig. Verander één teken in het bestand en upload het opnieuw: de controle meldt dat het is gewijzigd.

    curl -sS https://verify.onwyn.io/api/v1/verify/code/ONW-4K7P-2M9X-QB3T

Zeven aanroepen

Vijf aanroepen op de sign-host, elk met uw API-sleutel. Twee op de verify-host, openbaar en gratis.

AanroepWat hij doet
POST /api/sealStuur een pdf. Ontvang de verzegelde pdf in dezelfde aanroep terug.
POST /api/signStuur een pdf en tot 10 ondertekenaars. Ontvang voor elke ondertekenaar een ondertekeningslink.
GET /api/sign/{id}Zie hoe ver het ondertekenen is, per ondertekenaar.
GET /api/sign/{id}/documentHet voltooide pdf-bestand downloaden.
GET /api/sign/{id}/progress-copyMeerdere ondertekenaars: een kopie na de eerste handtekening. Niet verzegeld, niet definitief.
GET /api/v1/verify/code/{code}Een code controleren. Openbaar, zonder sleutel.
POST /api/v1/verify/uploadEen pdf-bestand controleren. Openbaar, zonder sleutel.

Een document ter ondertekening sturen

Het antwoord bevat een ondertekeningslink voor elke ondertekenaar. U toont de link in uw product of verstuurt hem zelf. De ondertekenaar opent hem in een browser, leest, geeft toestemming en ondertekent, zonder account en zonder app. Met een terugkeeradres komt de browser daarna terug in uw product.

curl -sS --max-time 120 \
  -H "Authorization: Bearer $ONWYN_API_KEY" \
  -F file=@quotation.pdf -F 'signer_name=Anna Muster' -F ref=SO42 \
  -F return_url=https://erp.example.com/orders/42 \
  https://sign.onwyn.io/api/sign
Meerdere ondertekenaars.
Tot 10, na elkaar of allemaal tegelijk.
Waar de handtekening komt.
Schrijf {{sign:1}} en {{date:1}} in de pdf, of stuur de pagina en de positie.
Alleen ondertekenen.
Stuur seal=false om de handtekeningen te krijgen zonder het Onwyn-zegel.
De naam van uw klant op het zegel.
Verkoopt u aan veel bedrijven? Stuur company_name mee met elke aanroep, dan noemt het zegel uw klant naast u.
Wachten op het resultaat.
Vraag de status elke 5 tot 10 seconden op, of zodra de ondertekenaar terugkomt op uw terugkeeradres. Download daarna het document.
Hetzelfde in Python
import os, requests

BASE = "https://sign.onwyn.io"
AUTH = {"Authorization": f"Bearer {os.environ['ONWYN_API_KEY']}"}

with open("quotation.pdf", "rb") as f:
    r = requests.post(f"{BASE}/api/sign", headers=AUTH, timeout=120,
                      files={"file": ("quotation.pdf", f, "application/pdf")},
                      data={"signer_name": "Anna Muster", "ref": "SO42"})
r.raise_for_status()
request = r.json()
print(request["signers"][0]["signing_url"])   # give this link to the signer

status = requests.get(request["status_url"], headers=AUTH, timeout=30).json()
if status["status"] == "completed":
    pdf = requests.get(status["document_url"], headers=AUTH, timeout=60).content

Goed om te weten voordat u bouwt

  • Via de API stuurt Onwyn geen e-mail. U geeft elke ondertekenaar zijn of haar link, en wie de link opent, kan ondertekenen. Het bewijsdossier vermeldt dat.
  • Een aanroep die opnieuw wordt verstuurd, maakt een nieuw document. Gebruik een time-out van 120 seconden. Bij 503 busy wacht u het aantal seconden uit Retry-After af en probeert u het opnieuw.
  • Deze API heeft nog geen webhooks. Vraag in plaats daarvan de status op.
  • Een pdf mag tot 25 MB en 100 pagina's hebben. Elk adres kan per minuut 30 verzegelingen en 30 ondertekeningsverzoeken doen, en tot 500 documenten per dag.
  • Tijdens de bèta bewaart Onwyn zijn kopie van een document 30 dagen. Download wat u nodig hebt en bewaar het.
  • Elke fout is JSON met een korte code en een duidelijke zin die zegt wat u moet aanpassen.
  • Het is een eenvoudige elektronische handtekening, verzegeld met Onwyns eigen certificaat en klok. Wat de bèta is en niet is.

Bij uw sleutel krijgt u de volledige API-referentie, met voorbeelden in curl, Python, PHP en Node, zo geschreven dat u hem aan een AI-programmeerassistent kunt geven.

Stuur uw ontwikkelaars naar ons

We plannen de integratie met uw team: welke aanroepen, waar de handtekening komt en hoe de namen van uw klanten op het zegel verschijnen.

Plan een integratie met ons

De API kost hetzelfde als de webapp. Bekijk de prijzen.