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/signaturesohne 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
429mit einemRetry-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.