Wie binde ich E-Signaturen mit der Sealique-API in meine eigene Software ein?

Wie sende ich ein PDF per Code zur Unterschrift?

Erstellen Sie unter „Integrationen“ einen API-Schlüssel und rufen Sie dann POST /api/v1/documents als Multipart (file, title, signers als JSON-String, signing_order) oder als JSON mit file_base64 auf. Fügen Sie einen Idempotency-Key-Header hinzu, damit ein erneuter Versuch nie zwei Dokumente erzeugt. Die Antwort enthält die Dokument-ID, ihren Status und signing_links, einen pro Unterzeichner. Unterzeichner öffnen den Link, akzeptieren die Einwilligungserklärungen und unterschreiben; mit auto_finalize (Standard) wird das Dokument versiegelt, sobald der letzte Unterzeichner unterschrieben hat.

curl-Beispiel: curl -X POST https://your-host/api/v1/documents -H "Authorization: Bearer af_test_…" -H "Idempotency-Key: order-1042" -F "file=@contract.pdf" -F "title=Service agreement" -F 'signers=[{"name":"Aline Uwase","email":"aline@example.com"}]' -F "signing_order=sequential"

Python-Beispiel: requests.post(base + "/api/v1/documents", headers={"Authorization": "Bearer af_test_…"}, files={"file": open("contract.pdf", "rb")}, data={"title": "Service agreement", "signers": '[{"name": "Aline Uwase", "email": "aline@example.com"}]'}).json()

JavaScript-Beispiel: const form = new FormData(); form.append("file", pdfBlob, "contract.pdf"); form.append("title", "Service agreement"); form.append("signers", JSON.stringify([{ name: "Aline Uwase", email: "aline@example.com" }])); const doc = await (await fetch(base + "/api/v1/documents", { method: "POST", headers: { Authorization: "Bearer af_test_…" }, body: form })).json();

Woher weiß ich, wann ein Dokument unterschrieben ist?

Registrieren Sie einen Webhook-Endpunkt (POST /api/v1/webhooks oder die Seite „Integrationen“) und abonnieren Sie die benötigten Ereignisse. Jede Zustellung ist ein JSON-Body mit dem Ereignisnamen und dem Dokument, signiert mit einem HMAC über einen Zeitstempel und den Body in einem Signatur-Header, damit Sie gefälschte Aufrufe ablehnen können; fehlgeschlagene Zustellungen werden wiederholt. Polling über GET /api/v1/documents/{id} liefert nach der Versiegelung denselben Status, verification_id und verify_url.

Wie rufe ich das versiegelte PDF ab und prüfe es?

GET /api/v1/documents/{id}/file gibt das versiegelte PDF zurück und /certificate das Abschlusszertifikat; beide benötigen den Scope documents:read. Um eine Datei von überall zu prüfen, rufen Sie GET /api/v1/verify/{verification_id} oder POST /api/v1/verify mit dem PDF auf; beide sind öffentlich und geben die Unterzeichner, den Zeitpunkt der Versiegelung und einen Integritätscode wie authentic, modified_after_sealing oder flattened_copy zurück. GET /api/v1/verify/{id}/page/{page}/{digest} prüft eine einzelne Seitenmarke.

Kann ich die Signaturseite in meine Anwendung einbetten?

Ja. Legen Sie die erlaubten Origins am API-Schlüssel fest; die Signaturseite sendet dann eine Content-Security-Policy, die Ihrem Origin das Einbetten erlaubt, und leitet nach dem Unterschreiben auf Ihre return_url weiter und sendet eine Nachricht mit dem Ereignis an das übergeordnete Fenster. Unterzeichner brauchen nie ein Konto.

Was kostet die API?

Derzeit nichts: Test- und Live-Schlüssel sind in jedem Konto enthalten, standardmäßig mit 120 Anfragen pro Minute und Schlüssel sowie Sandbox-Dokumenten, die keine E-Mails versenden. Die OpenAPI-Beschreibung unter /api/v1/openapi.json lässt sich in Postman, Insomnia oder einen Codegenerator importieren.