Eine sichere API für digitale Signaturen

Integrieren Sie unterschreib.es in CRM-, ERP- oder Branchenlösungen – mit einer durchdachten REST-API, OpenAPI-Spezifikation und Token-Authentifizierung.

Sicher, dokumentiert, deutsch gehostet

Unsere API folgt durchgängig den Best Practices für moderne Web-APIs: Bearer-Token-Authentifizierung, klare Statuscodes, vollständige OpenAPI/Swagger-Spezifikation und ein deutsch sprechender Support.

Sie generieren persönliche API-Tokens in Ihren Einstellungen und verwenden diese als Bearer-Token im Authorization-Header. Tokens sind ausschließlich gehasht in unserer Datenbank gespeichert – wir können sie nicht zurückgeben.

Die OpenAPI-Spezifikation finden Sie unter /swagger auf der API-Subdomain.

Der Flow im Überblick

  1. Dokument hochladen – POST /v1/documents mit der PDF-Datei und einem Titel.
  2. Signaturanforderungen erstellen – POST /v1/documents/{id}/requests für jede:n Empfänger:in inkl. Position auf der Seite.
  3. Versand starten – POST /v1/documents/{id}/send verschickt die Einladungs-E-Mails.
  4. Status abfragen – GET /v1/documents/{id} liefert jederzeit den aktuellen Stand.
  5. Signiertes PDF abholen – GET /v1/documents/{id}/file nach Abschluss aller Signaturen.

Beispiel-Request

curl -X POST https://api.unterschreib.es/v1/documents \
    -H "Authorization: Bearer ues_..." \
    -F "file=@vertrag.pdf" \
    -F "title=Kaufvertrag PKW"

Antwort: JSON mit der ID des erzeugten Dokuments. Nutzen Sie diese ID, um Signaturanforderungen anzulegen.