FÜR DEINE ANWENDUNGEN

Dein Dokumentablauf. Automatisiert.

Die Business API verwendet dieselben Dokumentregeln und Kontingente wie dein Konto. Nach Anmeldung mit 2FA erstellst du unter Einstellungen → API & Automatisierung einen eigenen Zugang.

Authentifizierung

Übertrage den einmal angezeigten Zugang ausschließlich serverseitig als Bearer-Token über HTTPS. Er läuft nach 7, 30 oder 90 Tagen ab und lässt sich jederzeit widerrufen. Wähle Lesen oder Lesen & Schreiben. Bei einem Wechsel aus Business werden Zugänge gesperrt. API-Zugänge gelten für den persönlichen Arbeitsbereich; Team-Verwaltung, Kontoeinstellungen und KI sind ausgeschlossen.

curl https://sign.tausio.de/api/documents \
  -H "Authorization: Bearer $TAUSIO_TOKEN"

PDF hochladen

curl https://sign.tausio.de/api/documents \
  -H "Authorization: Bearer $TAUSIO_TOKEN" \
  -F "file=@vertrag.pdf"

Die Antwort enthält document.id. Uploads sind auf 15 MB und 150 Seiten begrenzt. Bereits signierte, verschlüsselte oder gedrehte PDFs werden nicht angenommen.

Wichtige Endpunkte

GET /api/documents GET /api/documents/{id} PATCH /api/documents/{id} POST /api/documents/{id}/send POST /api/documents/{id}/cancel POST /api/documents/{id}/clone POST /api/documents/{id}/trash POST /api/documents/{id}/restore GET /api/documents/{id}/file?final=1&download=1 GET /api/documents/{id}/audit GET /api/templates POST /api/drafts GET /api/drafts/{id} PATCH /api/drafts/{id} POST /api/drafts/{id}/prepare GET /api/contacts POST /api/contacts GET /api/folders POST /api/folders GET /api/billing

Empfänger und Felder vorbereiten

Jede Person braucht eine neue UUID und mindestens ein Signaturfeld. Koordinaten sind Anteile von 0 bis 1, der Ursprung liegt oben links. page beginnt bei 0. Empfänger und Felder lassen sich nur im Entwurf ändern. Hole die aktuelle Felddefinition über GET ab und prüfe sie vor dem Versand.

{
  "title": "Vertrag",
  "recipients": [
    {
      "id": "11111111-1111-4111-8111-111111111111",
      "name": "Erika Muster",
      "email": "erika@example.org"
    }
  ],
  "fields": [
    {
      "id": "22222222-2222-4222-8222-222222222222",
      "page": 0,
      "x": 0.1,
      "y": 0.75,
      "width": 0.35,
      "height": 0.07,
      "recipientId": "11111111-1111-4111-8111-111111111111",
      "type": "signature"
    }
  ]
}

Versand und Status

POST /api/documents/{id}/send
Content-Type: application/json

{"delivery":"email","days":30,"message":"Bitte prüfen und unterzeichnen."}

Verwende delivery=link, um persönliche Links statt einer automatischen E-Mail zu erhalten. E-Mail benötigt einen bestätigten Plattform- oder eigenen SMTP-Zugang. Vorlagenkopien werden zu einem neuen Entwurf; sie zählen erneut zum Kontingent. Prüfe den Status über GET. Nach completed kannst du die fertige PDF abrufen. Ein cancel deaktiviert Links und ersetzt keine zivilrechtliche Kündigungs- oder Widerrufserklärung.

Textdokument aus einer Vorlage

POST /api/drafts
{"title":"Meine Projektfreigabe","template":"approval"}

POST /api/drafts/{id}/prepare
{"signatures":true,"people":[{"name":"Erika Muster","email":"erika@example.org"}],"values":{"project":"Website – Stand 1.0","scope":"Freigabe der genannten Fassung"},"assignments":{}}

prepare erzeugt die PDF mit Feldern und gibt id zurück. Für eigene Rich-Text-Dokumente verwendet content die im Editor abrufbare JSON-Struktur. Pflichtangaben müssen vor Vorbereitung oder Unterschrift ergänzt werden. Vorlagen sind rechtlich individuell zu prüfen.

Fehler und Grenzen

401: Zugang fehlt oder ist ungültig. 403: Rechte fehlen. 404: Objekt gehört nicht zum Arbeitsbereich. 409: Vorgangszustand erlaubt die Aktion nicht. 410: Link widerrufen, abgelaufen oder Dokument im Papierkorb. 413: Dateigröße oder Speichergrenze. 429: Anfragebegrenzung. Maximal 120 API-Anfragen je Zugang und Minute; zusätzliche IP- und Aktionsgrenzen können früher greifen. Schreibaufrufe sind nicht automatisch idempotent: Prüfe nach Verbindungsfehlern den Bestand, bevor du Uploads oder Kopien wiederholst. Es gibt derzeit keine Webhooks.