PDFHQ-Logo

Dokumente

DokumentationPDF-Operationen

PDF signieren (sichtbare Markierungen) API

Platziere einen getippten Namen, ein Datum oder ein gezeichnetes Signaturbild auf einer PDF mit dem gemessenen Task-Lebenszyklus. Dies überprüft keine Identitäten und stellt keine zertifikatgestützten kryptografischen Signaturen aus.

Server-seitige API-Schlüssel Signierte Speicher-Uploads

Endpunkt- und Task-Semantik#

Operationscode: sign

Starten Sie diesen Vorgang mit POST /v1/tasks und den oben angezeigten Tool-Code. Lade Quell-PDFs hoch und füge sie an (oder verwende Task-bezogene Upload-Endpunkte), dann rufe auf POST /v1/tasks/{task_id}/process mit Operationseinstellungen.

Füge eine überprüfte sichtbare Signatur, Initialen oder ein Datum zu Dokumenten mit Genehmigung des Unterzeichners hinzu.

Eingaben: Genau ein versiegeltes PDF; 1–12 Markierungen; maximal 100 MiB und 500 Seiten (Planeinschränkungen können niedriger sein). Dokumente, die bereits digitale Signaturen enthalten, werden abgelehnt.

Konfiguration und zusätzliche Parameter#

EinstellungTypVerhalten
markserforderlich object[]1–12 Markierungen; jede enthält Seite (1-basiert), x0, y0, x1, y1 in PDF-Punkten oben links und Art: eingegeben, Datum oder gezeichnet. Eingegebene/Datums-Markierungen enthalten Text; gezeichnete Markierungen enthalten Base64-PNG-Bytes (ohne Data-URL-Präfix). Bilder max. 96 KiB, 1600 × 600 Pixel.

Optionen werden von der API validiert. Unbekannte Einstellungen und nicht unterstützte Werte geben einen Fehler zurück, statt ignoriert zu werden.

Arbeitende Anforderungssequenz#

Programming language: cURL

Wähle eine Sprache · scrolle horizontal für alle 10 SDK-Sprachen

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 ↓Vollständige Python-Anleitung ↓ Vollständige Bash/cURL-Anleitung ↓ Alle Endpoints → Direkte Uploads → Fehlerbehandlung →

Generierte herunterladbare Pakete decken nur den Task-Workflow ab. Vollständige SDKs erfordern eine verifizierte OpenAPI-Spezifikation; die Python-, JavaScript- und TypeScript-Task-SDKs streamen Datei-Uploads; die anderen Sprachen erfordern signierte Multipart-Uploads, die vom Aufrufer implementiert werden.

Die zurückgegebene Aufgaben-ID wird sowohl für die Statusabfrage als auch für den Abruf verwendet. Nachdem die Aufgabe erfolgreich war, fordern Sie eine signierte Ausgabe-URL an, anstatt ein Download-Geheimnis einzubetten.

Ausgabe und wichtige Details#

Neues PDF mit sichtbaren Signaturmarken in den angeforderten Rechtecken. Quellseiten und Originaltext bleiben zugänglich.

Diese Operation erstellt KEIN digitales Zertifikat, Empfänger-Audit-Trail, Compliance-Bescheinigung oder Signaturidentitätsverifizierung. Vorhandene PDF-Digitalsignaturen werden abgelehnt; gedrehte Zielseiten werden nicht unterstützt. Für geschäftsgradige Empfänger-Signatur-Workflows integriere einen dedizierten Anbieter.

Fehler, Wiederholungen und Abrechnung
PDFHQ-Logo

PDF-Werkzeuge und Dokumentenanalyse. Dokumente vorbereiten, verstehen und bearbeiten.

© 2026 PDFHQ. Alle Rechte vorbehalten.