Developer API

Authentifizierung

Verwenden Sie Scoped API Keys mit Bearer-Token-Authentifizierung. Erstellen Sie Keys mit spezifischen Berechtigungen: signing:read, signing:write, billing:read, billing:write.

Endpunkte

Webhooks

Erhalten Sie Echtzeit-Benachrichtigungen, wenn Dokumente unterschrieben, abgelehnt oder abgelaufen sind. Alle Webhook-Payloads sind mit SHA-256 HMAC-signiert.

Idempotenz

Senden Sie einen Idempotency-Key-Header bei Schreiboperationen, um Anfragen sicher wiederholen zu koennen.

Unterschriftsanfrage erstellen

curl -X POST /api/v1/signing-requests \
  -H "Authorization: Bearer sk_live_..." \
  -H "Idempotency-Key: req_abc123" \
  -F "file=@vertrag.pdf" \
  -F "document_name=Vertrag.pdf" \
  -F "recipient_name=Max Mustermann" \
  -F "recipient_email=max@example.at" \
  -F "send_email=true" \
  -F "expires_in_days=30"

Antwort

{
  "id": "sr_a1b2c3d4...",
  "document_name": "Vertrag.pdf",
  "status": "pending",
  "signing_url": "/sign/...",
  "created_at": "2026-02-13T10:00:00Z"
}

Webhook Payload

{
  "event": "signing_request.signed",
  "timestamp": "2026-02-13T10:30:00Z",
  "data": {
    "uuid": "sr_a1b2c3d4...",
    "status": "signed",
    "signed_at": "2026-02-13T10:30:00Z"
  }
}