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.
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#
| Einstellung | Typ | Verhalten |
|---|---|---|
| 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
# 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.
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