PDFHQ-logo

Documenten

DocumentatiePDF-bewerkingen

PDF ondertekenen (Zichtbare markeringen) API

Plaats een getypte naam, datum of getekende handtekeningafbeelding op een PDF met behulp van de gemeten taaklevenscyclus. Dit verifieert geen identiteiten en geeft geen certificaatgesteunde cryptografische handtekeningen uit.

Server-side API-sleutels Ondertekende opslagupload

Eindpunt- en taaksemantiek#

Bewerkingscode: sign

Start deze bewerking met POST /v1/tasks en de hierboven weergegeven toolcode. Upload en voeg bron-PDF's toe (of gebruik taakgerelateerde upload-eindpunten), vervolgens roep aan POST /v1/tasks/{task_id}/process met bewerkingsinstellingen.

Voeg een gecontroleerde zichtbare handtekening, initialen of datum toe aan documenten met toestemming van de ondertekenaar.

Invoer: Exact één verzegelde PDF; 1–12 markeringen; maximaal 100 MiB en 500 pagina's (planlimieten kunnen lager zijn). Documenten die al digitale handtekeningen bevatten, worden afgewezen.

Configuratie en extra parameters#

InstellingTypGedrag
marksverplicht object[]1–12 markeringen; elk bevat pagina (1-gebaseerd), x0, y0, x1, y1 in PDF-punten linksboven en soort: getypt, datum of getekend. Getypte/datummarkeringen bevatten tekst; getekende markeringen bevatten base64 PNG-bytes (zonder data URL-voorvoegsel). Afbeeldingen max. 96 KiB, 1600 × 600 pixels.

Opties worden gevalideerd door de API. Onbekende instellingen en niet-ondersteunde waarden retourneren een fout in plaats van te worden genegeerd.

Werkende aanvraagvolgorde#

Programming language: cURL

Kies een taal · scroll horizontaal voor alle 10 SDK-talen

API example · cURL
# Server-side API calls. Save the returned task_id.
curl -fsS -X POST 'https://api.pdfhq.io/v1/tasks' \
  -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"tool":"sign"}'

# Upload and verify 1 PDF(s), then obtain and approve a credit quote:
curl -fsS 'https://api.pdfhq.io/v1/tasks/TASK_ID/quote' -H 'x-api-key: YOUR_API_KEY'

# ONLY after explicit customer approval:
test "$PDFHQ_APPROVE_QUOTE" = yes || { echo "Approval required" >&2; exit 1; }
curl -fsS -X POST 'https://api.pdfhq.io/v1/tasks/TASK_ID/process' \
  -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"options":{"marks":[{"kind":"typed","page":1,"x0":72,"y0":650,"x1":320,"y1":715,"text":"Jane Doe"}]}}'

curl -fsS 'https://api.pdfhq.io/v1/tasks/TASK_ID' -H 'x-api-key: YOUR_API_KEY'

After starting a task, upload and verify PDFs, review the credit quote, and get explicit approval before processing. API keys belong on your server, never on signed storage uploads.

All 10 SDKs ↓Volledige Python-walkthrough ↓ Volledige Bash/cURL-walkthrough ↓ Alle eindpunten → Directe uploads → Foutafhandeling →

Gegenereerde downloadbare pakketten dekken alleen de taakwerkstroom. Full-service SDK's vereisen een geverifieerde runtime OpenAPI-specificatie; de Python-, JavaScript- en TypeScript-taak-SDK's streamen bestandsuploads; de andere talen vereisen ondertekende multipart-uploads geïmplementeerd door de aanroeper.

De geretourneerde taak-ID wordt gebruikt voor zowel statuspolling als ophalen. Nadat de taak is voltooid, vraagt u een ondertekende uitvoer-URL aan in plaats van een downloadgeheim in te sluiten.

Uitvoer en belangrijke details#

Nieuw PDF met zichtbare handtekeningmarkeringen in de aangevraagde rechthoeken. Bronpagina's en originele tekst blijven toegankelijk.

Deze bewerking maakt GEEN digitaal certificaat, ontvangersaudittrail, nalevingsattest of verificatie van ondertekenersidentiteit. Bestaande PDF-digitale handtekeningen worden afgewezen; geroteerde doelpagina's worden niet ondersteund. Voor zakelijke ondertekeningsworkflows voor ontvangers integreert u een speciale provider.

Fouten, nieuwe pogingen en facturering
PDFHQ-logo

PDF-tools en documentintelligentie. Bereid, begrijp en werk met uw documenten.

© 2026 PDFHQ. Alle rechten voorbehouden.