📖 Inhaltsverzeichnis
Mehr zur Sandbox-Umgebung
Die Yousign-API bietet zwei Umgebungen an:
Sandbox – Umgebung zur Erkundung innerhalb der Yousign-API.
Produktion – Umgebung für Ihre Live-API-Integration.
Diese Umgebungen sind komplett getrennt voneinander. In der Sandbox-Umgebung können Entwickler:innen auf sichere Weise mit dem Code und den Funktionen experimentieren, ohne dabei die Live-Produktionsumgebung zu beeinträchtigen.
Signaturanfragen, die in der Sandbox-Umgebung erstellt werden, sind nur zu Testzwecken da. Sie sind nicht rechtsgültig.
Mehr Infos zu unserer Sandbox-Umgebung finden Sie in unserer API-Dokumentation (nur auf Englisch verfügbar).
Auf manche Sandbox-Ressourcen können Sie direkt in der Yousign-Web-App zugreifen.
So aktivieren Sie den „Sandbox-Modus“ in Ihrer Web-App
Voraussetzungen
Um auf Ihre Sandbox-Ressourcen zuzugreifen, muss das Folgende erfüllt sein:
Sie müssen Eigentümer:in oder Administrator:in sein. Nutzer:innen können nicht auf den Sandbox-Modus zugreifen.
Sie müssen in Ihrer Organisation mindestens einen Sandbox-API-Schlüssel erstellt haben. In diesem Artikel erfahren Sie mehr.
So aktivieren Sie den Sandbox-Modus:
Aktivieren Sie im linken Seitenmenü der Web-App den Sandbox-Modus-Schalter.
Jetzt befindet sich die Web-App im Sandbox-Modus.
Sobald der Modus aktiviert ist, können Sie die in der Web-App verfügbaren Sandbox-Ressourcen im „Sandbox-Modus“ erkunden.
Bitte beachten Sie, dass die Sandbox-Umgebung in der Web-App im Vergleich zur Produktionsumgebung aktuell eingeschränkte Funktionen anbietet.
Einschränkungen der In-App-Sandbox-Umgebung:
Web-App-Seite | Verfügbarkeit |
Vorlagen | ✅ Verfügbar |
Kontakte | ✅ Verfügbar |
API > Webhooks | ✅ Verfügbar |
Signaturanfragen | 🟡 Teilweise verfügbar:
|
Posteingang | ❌ Nicht verfügbar |
Dokumente | ❌ Nicht verfügbar |
Integrationen | ❌ Nicht verfügbar |
API > API-Schlüssel | ❌ Nicht verfügbar |
API > iFraming | ❌ Nicht verfügbar |
API > Protokolle | ❌ Nicht verfügbar |
Abrechnung | ❌ Nicht verfügbar |
Einstellungen | ❌ Nicht verfügbar |
Fehlerbehebung: Ich bin Administrator:in und kann nicht auf den Sandbox-Modus zugreifen
In diesem Fall sehen Sie beim Versuch, den Sandbox-Modus zu aktivieren, diese Fehlermeldung auf dem Bildschirm.
Das bedeutet, dass Ihr:e Web-App-Benutzer:in auf keinen der Workspaces Ihrer Organisation in der Sandbox-Umgebung Zugriff hat.
Sie können das Problem beheben, indem Sie Ihren Account zu einem oder mehreren der Sandbox-Workspaces hinzufügen. Das geht aktuell nur über die API:
Rufen Sie Ihre user ID ab, indem Sie eine Anfrage an den List Users Endpoint senden.
Fragen Sie die ID(s) des/der Workspaces in der Sandbox-Umgebung ab, zu denen Sie dem/der Benutzer:in Zugriff verschaffen möchten, indem Sie eine Anfrage an den List Workspaces Endpoint senden.
Fügen Sie in der Sandbox-Umgebung Ihre user ID einem Workspace hinzu, indem Sie eine Anfrage an den Associate a user to a workspace Endpoint senden.
Sobald Ihr Account Zugriff auf einen Sandbox-Workspace hat, sollten Sie auf den Sandbox-Modus in der Web-App zugreifen können.