Erste Schritte

Wenn Sie elektronisches Signieren in Ihr eigenes System einbauen möchten, bietet Ihnen die Swisscom Sign Integration API einen Backend-orientierten Ablauf, um Signierprozesse zu erstellen, zu konfigurieren, freizugeben und zu überwachen.

Diese Anleitung folgt demselben Pfad wie die Swisscom-Referenzdokumentation: den Lebenszyklus verstehen, einen Integrationsstil wählen, sich per OAuth2 authentifizieren und in der Sandbox testen, bevor Sie produktiv gehen. Prüfen Sie vor dem produktiven Einsatz die Geschäftsbedingungen.

Integrationsmöglichkeiten

Es gibt zwei gängige Integrationsmodelle:

1. Verwendung der Zugangsdaten Ihrer Kundinnen und Kunden. In diesem Modell abonnieren die Endkunden den Dienst und verwalten den Zugriff für ihre eigene Organisation.
2. Verwendung der Zugangsdaten Ihrer Plattform. In diesem Modell bietet Ihre Anwendung das Signieren als Bestandteil Ihres eigenen Produkts an und verwaltet den API-Zugriff zentral.

Für fortgeschrittene Szenarien wie eigene Domains, eigene Zertifikate, Verschlüsselungsmaterial oder SSO setzt Swisscom einen dedizierten Onboarding-Prozess voraus.

Typischer Integrationsablauf

1. Einen Prozess mit POST /api/process erstellen.
2. Ein oder mehrere PDF-Dokumente anhängen.
3. Den Prozess entweder direkt freigeben oder an die Setup-UI übergeben.
4. Den Signaturablauf für eine bestimmte Person öffnen, falls Sie einen Deep-Link benötigen.
5. Den Status-Endpoint abfragen, bis der Prozess abgeschlossen ist.
6. Das finale Dokument und den Audit-Datensatz herunterladen.

Siehe Konzepte für den vollständigen Lebenszyklus und die Endpunkt-Referenz.

API Explorer verwenden

Der Reiter API Explorer in dieser Anwendung lädt den aktuellen OpenAPI-Contract direkt von Swisscom und bietet einen interaktiven REST-Client für Authentifizierung, Inspektion von Request-Payloads und Endpoint-Tests.