# Sig.Surf REST API

Quelle: https://sig.surf/de/integrations/rest-api (Markdown-Version der Seite)

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](https://sig.surf/de/integrations/mcp-server).
