Integrationen

Sig.Surf REST API

Eine JSON-API zum Erstellen von Signaturen und Verwalten von Mitarbeitenden, mit einer OpenAPI-Beschreibung unter einer stabilen URL.

Signaturen, die über diese Schnittstelle entstehen, sind für Gmail und Google Workspace gedacht.

Was du damit machen kannst

  • POST /api/v1/signatures ohne Zugangsdaten nimmt eine Vorlagen-ID oder ein Signaturdokument plus Feldwerte entgegen und liefert gerendertes HTML, reinen Text, Warnungen und einen Claim-Link zurück. Jemand meldet sich später an und übernimmt die Signatur. Nicht übernommene Signaturen verfallen nach 30 Tagen.
  • Mit einem API-Schlüssel kannst du die Mitarbeitenden deiner Organisation auflisten und aktualisieren.
  • Den Vorlagenkatalog auflisten.

Konventionen

  • JSON rein, JSON raus. Fehler sehen so aus: { "error": { "code", "message" } }, mit dem passenden HTTP-Status.
  • API-Schlüssel beginnen mit ssk_, handeln für eine Organisation und werden als Bearer-Token gesendet. Von jedem Schlüssel wird nur ein Hash gespeichert.
  • Request-Bodys sind auf 64 KiB begrenzt. Für anonyme Aufrufe gilt ein Rate-Limit, und du bekommst 429 mit einem Retry-After-Header.
  • Das OpenAPI-3.1-Dokument liegt unter /api/v1/openapi.json.

Für Assistenten, die MCP sprechen, gibt es den MCP-Server.

Diese Seite gibt es auch als Markdown.