MOXIS API Dokumentation
German English

MOXIS REST API: Anhang

Inhalt

Dieses Kapitel bietet einen kompakten Überblick über die verfügbaren MOXIS Varianten, deren REST-API-Funktionsumfang und die jeweils nutzbaren Prozess-IDs. Zusätzlich enthält sie die Nutzungsbedingungen für den kostenlosen API-Testzugang, einschließlich Zweckbindung, Einschränkungen, Haftung, Datenschutz und Deaktivierung.


1. Funktionseinschränkungen nach MOXIS Variante

MOXIS ist in mehreren Varianten verfügbar. Der über die REST-API zugängliche Funktionsumfang unterscheidet sich erheblich danach, auf welcher Stufe Ihre Instanz betrieben wird. Diese Seite fasst diese Unterschiede zusammen, damit Sie wissen, was Sie vor dem Aufbau einer Integration erwarten können.

1.1. Übersicht über die MOXIS Varianten

Funktion

Now Cloud

Business Cloud

Enterprise Cloud

REST-API-Zugriff

Ja

Ja

Ja

Prozesskonfiguration

Nein

Nein

Ja

Webhooks

Nein

Nein

Ja

OAuth-/IDP-Anbindung

Nein

Nein

Ja

Vollständiger API-Umfang

Teilmenge

Teilmenge

Vollständig

Swisscom Seal API

Nein

Nein

Ja

1.2. Wichtige Einschränkungen für die MOXIS Now Cloud und die MOXIS Business Cloud

Wenn Sie die MOXIS Now Cloud oder die MOXIS Business Cloud nutzen, beachten Sie Folgendes:

  • Prozesse können nicht konfiguriert werden.
    Sie müssen die unten aufgeführten festen Prozess-IDs verwenden. Benutzerdefinierte Prozess-Workflows stehen nicht zur Verfügung.

  • Webhooks stehen nicht zur Verfügung.
    Sie können keine Ereignis-Callbacks empfangen, wenn sich der Status eines Signaturvorgangs ändert. Sie müssen Polling oder einen anderen Benachrichtigungsmechanismus verwenden.

  • Keine IDP-/SSO-Anbindung.
    Es gibt keine Identity-Provider-Integration; die Benutzerbereitstellung erfolgt daher manuell durch den Instanzeigentümer. Die Authentifizierung erfolgt meist über die E-Mail-Adresse. Stimmen Sie sich mit Ihrem Instanzeigentümer ab, wie Benutzer identifiziert und bereitgestellt werden.

  • OAuth wird nicht unterstützt.
    Auf der MOXIS Now Cloud und der MOXIS Business Cloud steht ausschließlich Basic Authentication zur Verfügung. OAuth ist eine reine Enterprise-Funktion.

1.3. Prozess-IDs

Bei jedem Aufruf eines POST-Endpunkts, der einen Signaturprozess startet, müssen Sie eine processId angeben. Die verfügbaren Prozess-IDs sind abhängig von Ihrer Variante und dem rechtlichen Geltungsbereich.

Business Cloud — Prozess-IDs

Business Cloud unterstützt zwei gesetzliche Rahmenwerke: eIDAS (Europa) und ZertES (Schweiz).

eIDAS-Prozesse:

Prozess-ID

Anzeigename in der UI

moxisStdMultiEidas

Dokument(e) signieren

moxisContainerEidas

Dokument mit Anhängen signieren

biometry

Dokument(e) mit biometrischen Merkmalen signieren

extAttachEidas

Dokumente mit externen Anhängen signieren

ZertES-Prozesse (Schweiz):

Die ZertES-Entsprechungen der oben genannten Prozesse 1 und 2 folgen demselben Namensschema, jedoch mit dem Suffix ...Zertes statt ...Eidas:

Prozess-ID

Beschreibung

moxisStdMultiZertes

Standard-Mehrfachdokument-Signatur (ZertES)

moxisContainerZertes

Signatur von Dokumenten mit Anhängen (ZertES)

Now Cloud — Prozess-IDs

Now Cloud verfügt über einen stärker eingeschränkten Satz an Prozessen:

Prozess-ID

Hinweise

basicNow

Standard-Signaturprozess für Now Cloud

biometry

Biometrischer Signaturprozess

extAttachNow

Dokumente mit externen Anhängen

1.4. Upgrade

Wenn Ihre Integration Funktionen erfordert, die in Ihrer akutellen Variante nicht verfügbar sind (etwa Webhooks, benutzerdefinierte Prozesskonfiguration, OAuth oder die Swisscom Seal API), wenden Sie sich an MOXIS, um ein Upgrade auf Enterprise Cloud zu besprechen.

2. Nutzungsbedingungen für den API Testzugang

Gültig für: MOXIS / MOXIS eStamp REST-API-Testzugang Version 1.0 BP-SK, Stand 02.07.2026

Dies ist die deutschsprachige Originalfassung dieses Dokuments (Version 1.0 BP-SK, Stand 02.07.2026). Bei rechtlichen Streitigkeiten ist ausschließlich das Originaldokument maßgeblich.

Diese Bestimmungen (“XiTrust Test-Zugangs-Bedingungen”) regeln die Nutzung eines kostenlosen, zeitlich befristeten Testzugangs zur REST-API-Schnittstelle der Software MOXIS oder MOXIS eStamp der XiTrust Secure Technologies GmbH (“Testzugang”), FN 219152h, Reininghausstraße 3, 8020 Graz, Österreich (“XiTrust”), durch ein Unternehmen (“Tester”). Mit Aktivierung des Testzugangs akzeptiert der Tester diese Bedingungen.

2.1. Vertragsabschluss und Anwendungsbereich

  • Der Vertrag über den Testzugang kommt mit Freischaltung des Zugangs durch XiTrust zustande, unabhängig von einem etwaigen späteren Abschluss eines kostenpflichtigen Vertrags.

  • Der Testzugang richtet sich an Tester, die im eigenen unternehmerischen Interesse Funktionalitäten prüfen möchten. Er begründet keinen Anspruch auf den Abschluss eines kostenpflichtigen Vertrags.

2.2. Zweck und Nutzungsbeschränkung

  • Der Testzugang darf ausschließlich zu Test-, Evaluierungs- und Entwicklungszwecken im Rahmen und unter Einhaltung der XiTrust Test-Zugangs-Bedingungen genutzt werden.

  • Jede darüberhinausgehende, vor allem produktive, Nutzung ist untersagt, insbesondere die Erzeugung rechtsverbindlicher elektronischer Signaturen mit Wirkung gegenüber Dritten sowie die Verwendung im Echtbetrieb des Testers oder Dritter.

  • Als Testdaten sollten ausschließlich fiktive Daten verwendet werden (“Testdaten”). Bei Eingabe echter personenbezogener Daten ist der Tester ausschließlich selbst für die Einhaltung der geltenden datenschutzrechtlichen Bestimmungen verantwortlich.

  • Last-, Penetrations- oder Sicherheitstests gegen die Testumgebung sind ohne vorherige schriftliche Zustimmung von XiTrust untersagt.

  • Die Weitergabe der Zugangsdaten an Dritte sowie die entgeltliche oder unentgeltliche Zurverfügungstellung des Testzugangs an Dritte ist nicht gestattet.

2.3. Keine Gewährleistung, kein Service Level

  • Der Testzugang wird rein unentgeltlich und ohne jegliche Gewährleistung zur Verfügung gestellt.

  • XiTrust übernimmt im Zusammenhang mit dem Testzugang keine Verpflichtung zu einer bestimmten Verfügbarkeit des Testzugangs oder der Testdaten, Reaktionszeit oder Fehlerbehebung. Es besteht keine Verpflichtung zu einem bestimmten Service-Level.

  • XiTrust ist berechtigt, den Testzugang jederzeit ohne Angabe von Gründen und ohne Vorankündigungsfrist einzuschränken, auszusetzen oder zu beenden.

2.4. Haftung

  • Soweit gesetzlich zulässig haftet XiTrust gegenüber dem Tester nur für direkte Schäden, die von XiTrust oder ihren Erfüllungsgehilfen vorsätzlich oder grob fahrlässig verursacht wurden, sowie für Personenschäden.

  • Jede darüber hinausgehende Haftung, wie etwa für Folgeschäden, entgangenen Gewinn, Umsatzverlust und Datenverlust, ist ausgeschlossen.

  • Der Tester haftet gegenüber XiTrust für Schäden, die aus einer vertragswidrigen Nutzung des Testzugangs entstehen, insbesondere bei Verstößen gegen Punkt 2.

2.5. Deaktivierung

  • XiTrust kann den Testzugang jederzeit fristlos deaktivieren, insbesondere bei Verdacht auf vertragswidrige Nutzung, Missbrauch oder bei sicherheitsrelevanten Auffälligkeiten.

  • Mit Ende des Testzugangs werden in der Testumgebung gespeicherte Testdaten automatisch gelöscht. Ein Anspruch auf Datenexport oder -wiederherstellung besteht nicht.

2.6. Geistiges Eigentum

  • Sämtliche Eigentums-, Urheber- und sonstige Immaterialgüterrechte am XiTrust Testzugang und der API-Dokumentation verbleiben ausschließlich bei XiTrust.

  • Der Tester erhält lediglich ein einfaches, nicht übertragbares und auf die Dauer des Testzugangs befristetes Recht zur Nutzung des Testzugangs im Rahmen dieser Trial-Bedingungen.

  • Feedback, Fehlermeldungen oder Verbesserungsvorschläge, die der Tester XiTrust im Zusammenhang mit dem Testzugang übermittelt, darf XiTrust frei und unentgeltlich nutzen und weiterentwickeln.

2.7. Geheimhaltung und Datenschutz

  • Informationen, die der Tester im Rahmen des Testzugangs erhält, sind vertraulich zu behandeln, dürfen nur für die Zwecke des Tests verwendet und nicht an Dritte weitergegeben werden.

  • Registrierungsdaten des Testers (Name, Firma, geschäftliche E-Mail-Adresse) verarbeitet XiTrust zum Zweck der Bereitstellung und Verwaltung des Testzugangs sowie zur Kontaktaufnahme im Zusammenhang mit einer möglichen späteren Kundenbeziehung. Nähere Informationen enthält die Datenschutzerklärung von XiTrust unter www.moxis.co.

  • Sollte der Tester entgegen Punkt 2 personenbezogene Daten Dritter in die Testumgebung eingeben, handelt er dabei in eigener datenschutzrechtlicher Verantwortung; eine Auftragsverarbeitungsvereinbarung mit XiTrust entsteht dadurch für den Testzugang nicht.

2.8. Schlussbestimmungen

  • Auf diese Bedingungen kommt ausschließlich österreichisches Recht unter Ausschluss der Kollisionsnormen und des UN-Kaufrechts zur Anwendung.

  • Ausschließlicher Gerichtsstand für alle Streitigkeiten ist das sachlich zuständige Gericht in Graz, Österreich.

  • Sollte eine Bestimmung unwirksam sein, bleibt die Wirksamkeit der übrigen Bestimmungen unberührt.