Dokumentation

sigillo versiegelt PDFs rechtsgültig über den Schweizer Signatur-Partner SwissTrustLayer — als Zeitstempel oder qualifizierte elektronische Signatur (QES). Drei Zugangswege teilen dieselbe Logik und dieselbe Credit-Buchhaltung.

REST-API

Interaktive OpenAPI-Referenz (Swagger-UI) — alle Endpunkte zum Ausprobieren.

/docs/api →

MCP-Server

sigillo als Tool für AI-Agenten (Claude, ChatGPT, n8n) einbinden.

/docs/mcp →

API-Token

Token im Dashboard erstellen — Voraussetzung für REST und MCP.

/app/tokens →

1. Authentifizierung

Alle Aufrufe nutzen einen Bearer-Token aus dem Dashboard:

Authorization: Bearer sig_xxxxxxxx…

Tokens tragen Scopes — seal:write schließt seal:read ein:

seal:readStatus, Download, Guthaben lesen

seal:writePDFs versiegeln (kostet Credits)

billing:manageCredits kaufen

account:manageToken-Verwaltung (nur Web-Login, nicht für API-Tokens vergebbar)

2. PDF versiegeln (REST)

Zeitstempel synchron — die versiegelte PDF kommt direkt zurück:

curl -X POST https://sigillo.ch/api/v1/seal/timestamp \
  -H "Authorization: Bearer sig_…" \
  -F pdf=@vertrag.pdf \
  -F signer_name=Daniel -F signer_surname=Schlager \
  --output sealed.pdf

QES (on_demand/mab) läuft asynchron: Antwort 201 mit einer request_id, dann den Status pollen, bis er completed ist, und herunterladen.

→ REST-Referenz

3. Aus dem AI-Agenten (MCP)

sigillo ist ein gehosteter MCP-Server mit vier Tools: seal_pdf, seal_status, seal_download, seal_balance.

→ MCP-Guide