Spanish English German Portuguese
Spanish English German Portuguese

GlobalSuite API: Anwendungsfälle

Was ist die GlobalSuite API und wann sollte sie verwendet werden?

Die GlobalSuite API ermöglicht die Verbindung der Plattform mit anderen Unternehmenssystemen, um Geschäftsinformationen abzufragen, zu erstellen, zu aktualisieren oder zu verknüpfen. In der Praxis werden wiederholte manuelle Arbeiten vermieden und GlobalSuite bleibt mit Tools wie CMDB, ITSM, Einkaufslösungen, Dokumenten-Repositories, Data Lakes, Dashboards oder Compliance-Plattformen synchronisiert.

Bedarf

Was die API bietet

Informationen importieren

Erstellen oder Aktualisieren von Datensätzen in GlobalSuite basierend auf Daten, die in einem anderen System gepflegt werden, z. B. Vermögenswerte, Mitarbeiter, Lieferanten oder Nachweise.

Informationen abfragen

Daten aus GlobalSuite extrahieren, um sie zu analysieren, zu konsolidieren oder in anderen Unternehmenssystemen anzuzeigen.

Beziehungen aufrechterhalten

Datensätze miteinander verknüpfen, z. B. Lieferanten mit Dienstleistungen, Vermögenswerte mit Bedrohungen, Tickets mit Verantwortlichen oder Nachweise mit Kontrollen.

Prozesse ausführen

Spezifische Aktionen oder Berechnungen ausführen, wie Risiko-Berechnungsanfragen oder Auswirkungen-Berechnungen im Zusammenhang mit Kontinuität.

Reporting automatisieren

Integrationen mit Daten-Repositories, Dashboards oder Management-Berichten vorbereiten, ohne ausschließlich auf manuelle Exporte angewiesen zu sein.

Schlüsselidee
Die API sollte nicht nur als eine Liste technischer Endpunkte verstanden werden. Jeder Endpunkt repräsentiert eine funktionale Fähigkeit von GlobalSuite: Inventar, Risiken, Tickets, Lieferanten, Nachweise, Prozesse, Dienstleistungen, Benutzer oder Konfiguration.

Vor dem Start: Zugang, Sicherheit und Grenzen

Vor der Gestaltung einer Integration sollten vier Aspekte validiert werden: Umgebung, Authentifizierung, Datenumfang und Nutzungslimits.

Aspekt

Was validiert werden muss

Dokumentationsumgebung

Die Referenzdokumentation wird in Swagger UI eingesehen. In der Demo Europa kann https://demo-eu.globalsuitesolutions.com/docs verwendet werden. In anderen Umgebungen muss die veröffentlichte URL für den jeweiligen Kunden oder die Region ersetzt werden.

Integrations-URL

Echte Anfragen müssen an die API-URL der entsprechenden Umgebung gerichtet werden, z. B. https://api-demo-eu.globalsuitesolutions.com/v1/ für die Demo Europa.

API-Schlüssel

Authentifizierte Anfragen erfordern einen API-Schlüssel oder Token mit definierter Gültigkeit. Wenn der Schlüssel außerhalb seines Gültigkeitsbereichs liegt, gibt die API einen Fehler 403 zurück.

Unterentitäten

Wenn der Kunde mit mehreren Untereinheiten arbeitet, muss normalerweise ein spezifischer API-Schlüssel für jede Einheit generiert werden, die integriert werden soll, da die Daten für jede Einheit spezifisch sind.

Rate Limit

Das auf der aktuellen Seite angegebene Limit beträgt 180 Anfragen pro Minute pro API-Schlüssel. Wenn es überschritten wird, kann die API mit 429 „Too Many Attempts“ antworten.

Versionierung

Die API wird in der Version Current angeboten. Wenn es zu einem Breaking Change kommt, kann die vorherige Version auf Deprecated gesetzt werden, um Zeit für die Anpassung der Integrationen zu geben.

Startempfehlung
Immer zuerst in einer Demo- oder Laborumgebung testen, bevor produktive Systeme verbunden werden. Das erste Ziel sollte nicht sein, alles zu automatisieren, sondern einen kleinen und kontrollierten Ablauf mit repräsentativen Daten zu validieren.

Wie man die Swagger-Dokumentation liest

Swagger UI zeigt die verfügbaren Modelle und Operationen. Für funktionale Benutzer ist es wichtig, nicht die Syntax auswendig zu lernen, sondern zu verstehen, was jede Operation darstellt und welche Auswirkungen sie auf die Daten hat.

Item

Wie man es interpretiert

Ressource oder Modell

Geschäftsobjekt von GlobalSuite: Vermögenswert, Ticket, Lieferant, Mitarbeiter, Nachweis, Dienstleistung, Prozess, Kontrolle usw.

GET-Methode

Abfrage eines oder mehrerer Datensätze. Wird häufig für Listen, Filter, Vorvalidierungen und Datenextraktion verwendet.

POST-Methode

Erstellt einen Datensatz oder führt eine Geschäftsaktion aus. Kann auch verwendet werden, um Objekte zu verknüpfen oder Berechnungen auszuführen.

PUT-Methode

Aktualisiert einen bestehenden Datensatz oder eine Beziehung. Sollte mit besonderer Vorsicht verwendet werden, um keine Informationen zu überschreiben.

DELETE-Methode

Löscht oder entkoppelt einen Datensatz. Sollte auf kontrollierte Prozesse mit Vorvalidierungen beschränkt werden.

Parameter in der Route

Werte wie {modelId}, {objectId}, {analysisId} oder {riskId} identifizieren den spezifischen Datensatz, auf den zugegriffen wird.

Abfrageparameter

Filter, Sortierung, Paginierung oder erweiterte Beziehungen. In einigen Listen kann expand verwendet werden, um verwandte Informationen abzurufen, wenn der Endpunkt dies zulässt.

Swagger-Referenz: API GlobalSuite - Swagger UI

Anwendungsfälle nach Funktionsbereich

Die folgenden Beispiele dienen dazu, zu verstehen, welche Geschäftsprobleme die API lösen kann und welche Endpunkte in Swagger überprüft werden sollten, um jede Integration umzusetzen.

1. Synchronisierung des Vermögensinventars aus einer CMDB oder ITSM-Tool

Geschäftsziel

Ein aktuelles Inventar von Vermögenswerten, Kategorien, Dimensionen und Abhängigkeiten in GlobalSuite führen, ohne wiederkehrende manuelle Uploads durchzuführen.

Beispielszenario

Das IT-Team verwaltet Server, Anwendungen oder technische Dienstleistungen in einer CMDB. GlobalSuite benötigt diese Vermögenswerte für Risikoanalysen, BIA, Compliance oder Reporting.

Empfohlener Ablauf

1) Verfügbare Kataloge und Dimensionen abfragen. 2) Prüfen, ob der Vermögenswert bereits existiert. 3) Den Vermögenswert erstellen oder aktualisieren. 4) Abhängigkeiten und Dimensionen pflegen. 5) Nachverfolgbarkeit im Ursprungssystem registrieren.

Vorteil für den Benutzer

Reduziert die Duplizierung von Inventaren, verbessert die Datenqualität und ermöglicht, dass Risikoanalysen, Kontinuität und Compliance auf einer gemeinsamen Basis aufbauen.

Methode

Endpunkt

Orientierungshilfe

GET

/assets

Vorhandene Vermögenswerte abfragen und Duplikate vermeiden.

POST

/assets

Neue Vermögenswerte erstellen, die in GlobalSuite verwaltet werden sollen.

PUT

/assets/{modelId}

Attribute eines bereits vorhandenen Vermögenswerts aktualisieren.

GET

/categories

Verfügbare Vermögenskategorien abfragen.

GET

/dimensions

Verfügbare Dimensionen und Ebenen abfragen.

POST

/assets/{modelId}/dependency/{objectId}

Abhängigkeiten zwischen Vermögenswerten erstellen.

PUT

/assets/{modelId}/dimensions/{objectId}

Dimensionenwerte des Vermögenswerts aktualisieren.

Empfehlung
Bei Vermögenswerten und Tickets können konfigurierbare Felder oder Strukturen vorhanden sein. Die Datenzuordnung sollte mit der spezifischen Konfiguration des Kunden und der Swagger-Dokumentation der Umgebung validiert werden.

2. Tickets aus externen Tools erstellen und aktualisieren

Geschäftsziel

GlobalSuite mit Support-, Audit-, Compliance- oder Aktionsmanagement-Tools verbinden, damit Tickets erstellt und synchronisiert werden.

Beispielszenario

Ein externes Tool erkennt eine Störung, einen Befund oder eine Korrekturmaßnahme. Die Organisation möchte diese in GlobalSuite mit Verantwortlichen, Nachweisen, Beziehungen und Nachverfolgung verwalten.

Empfohlener Ablauf

1) Den Tickettyp und seine Felder identifizieren. 2) Das Ticket erstellen. 3) Verantwortliche, Mitarbeiter, Dateien oder Beziehungen verknüpfen. 4) Das Ticket aktualisieren, wenn sich der Status im externen System ändert.

Vorteil für den Benutzer

Ermöglicht die Zentralisierung der Nachverfolgung in GlobalSuite, ohne dass die Teams manuell Informationen eingeben müssen, die bereits in anderen Tools vorhanden sind.

Methode

Endpoint

Richtliniennutzung

GET

/ticketTypes

Verfügbare Tickettypen abrufen.

GET

/ticketTypes/{modelId}/fields

Konfigurierte Felder für einen Tickettyp abrufen.

GET

/tickets

Vorhandene Tickets suchen oder deren Status abrufen.

POST

/tickets

Ein neues Ticket erstellen.

PUT

/tickets/{modelId}

Ticketdaten aktualisieren.

POST

/tickets/{modelId}/owners/{objectId}

Verantwortliche dem Ticket zuordnen.

POST

/tickets/{modelId}/files

Dokumentation oder Nachweise an das Ticket anhängen.

POST

/tickets/{modelId}/ticketRelations/{objectId}

Das Ticket mit anderen Einträgen verknüpfen.

Empfehlung
Die Ticket-API ist umfangreich, da sie von konfigurierbaren Typen, Berechtigungen, Beziehungen und dynamischen Feldern abhängt. Es ist ratsam, mit einem einzigen Tickettyp zu beginnen und später zu erweitern.

3. Risikoanalysen abrufen und Berechnungen automatisieren

Geschäftsziel

Informationen aus Risikoanalysen extrahieren oder Berechnungen aus automatisierten Prozessen starten, beispielsweise zur Erstellung von Berichten, Audits oder Dashboards.

Beispielszenario

Ein Team muss Vermögenswerte, Bedrohungen, Kontrollen und Risiken in einem Unternehmensrepository konsolidieren oder eine Neuberechnung durchführen, wenn wichtige Informationen aktualisiert werden.

Empfohlener Ablauf

1) Analyse identifizieren. 2) Eingeschlossene Vermögenswerte abrufen. 3) Verwandte Bedrohungen, Kontrollen und Risiken abrufen. 4) Berechnungsanfragen ausführen, wenn erforderlich. 5) Ergebnisse in Berichten nutzen.

Vorteil für den Benutzer

Verbessert die Nachverfolgbarkeit der Analyse, ermöglicht die Automatisierung von Berichten und verkürzt die Zeit für regelmäßige Risikoüberprüfungen.

Methode

Endpoint

Richtliniennutzung

GET

/analysis/{modelId}/assets

Eingeschlossene Vermögenswerte in einer Analyse abrufen.

GET

/analysis/{modelId}/controls

Kontrollen, die mit der Analyse verbunden sind, abrufen.

POST

/analysis/{modelId}/controls

Kontrollen zur Analyse hinzufügen, falls zutreffend.

POST

/analysis/{modelId}/assets/{assetId}/threats/{threatId}/calculateRequest

Berechnung im Zusammenhang mit einer Bedrohung anfordern.

POST

/analysis/{modelId}/calculateThreatSimulationRequest

Eine Bedrohungssimulation starten.

POST

/analysis/{modelId}/calculateControlSimulationRequest

Eine Kontrollsimulation starten.

GET

/analysisCatalogs/{modelId}/threats/{threatId}/controls

Katalogkontrollen, die mit Bedrohungen verbunden sind, abrufen.

Empfehlung
Berechnungsoperationen sollten als Geschäftsprozesse behandelt werden. Vor der Automatisierung ist es ratsam zu validieren, wann sie ausgeführt werden sollen und welche Daten geändert oder neu berechnet werden.

4. Ergebnisse von BIA und Auswirkungen berechnen konsolidieren

Geschäftsziel

Berechnungen im Zusammenhang mit der Geschäftskontinuität automatisieren, wie MTPD oder betroffene RTO, basierend auf in GlobalSuite konfigurierten Kriterien.

Beispielszenario

Die Organisation muss Auswirkungen nach Änderungen an Prozessen, Vermögenswerten oder Abhängigkeiten neu berechnen oder Ergebnisse für Berichte zur Kontinuität konsolidieren.

Empfohlener Ablauf

1) BIA-Konfiguration und Berechnungskriterien überprüfen. 2) Die entsprechende Berechnungsanfrage senden. 3) Ergebnis in GlobalSuite und den zugehörigen Berichten überprüfen.

Vorteil für den Benutzer

Hilft, die Kontinuitätsindikatoren aktuell zu halten, ohne ausschließlich auf manuelle Überprüfungen angewiesen zu sein.

Methode

Endpoint

Richtliniennutzung

POST

/calculateAccumulatedMtpd

Kumulierte MTPD berechnen.

POST

/calculateImpactedMtpd

Betroffene MTPD berechnen.

POST

/calculateImpactedRto

Betroffene RTO berechnen.

Empfehlung
Diese Berechnungen hängen von der funktionalen Konfiguration des BIA ab. Sie sollten mit kontrollierten Daten getestet werden, bevor Massenoperationen automatisiert werden.

5. Prozesse, Dienstleistungen und Geschäftsbeziehungen synchronisieren

Geschäftsziel

Die Prozess- und Dienstkarte von GlobalSuite mit Unternehmensinventaren, Dienstkatalogen oder Unternehmensarchitektur-Repositorys verbinden.

Beispielszenario

Die Geschäftsabteilung verwaltet Prozesse und Dienstleistungen in einem Unternehmenswerkzeug, aber GlobalSuite benötigt sie für Kontinuität, Risiken, Compliance und Dashboards.

Empfohlener Ablauf

1) Vorhandene Prozesse und Dienstleistungen abrufen. 2) Grundlegende Informationen erstellen oder aktualisieren, wenn erforderlich. 3) Mitarbeiter, Stakeholder, Eingaben, Aktionen und Ausgaben pflegen. 4) Metriken für Berichte konsolidieren.

Vorteil für den Benutzer

Ermöglicht eine gemeinsame Sichtweise zwischen Service-Management, Kontinuität, Risiken und Executive Reporting.

Methode

Endpoint

Richtliniennutzung

GET

/processes

Geschäftsprozesse abrufen.

GET

/processes/{modelId}

Details eines Prozesses abrufen.

GET

/processes/{modelId}/employees

Mitarbeiter abrufen, die mit dem Prozess verbunden sind.

GET

/processes/{modelId}/inputActionOutput

Eingaben, Aktionen und Ausgaben des Prozesses abrufen.

GET

/services

Dienste abrufen.

POST

/services

Dienste erstellen.

PUT

/services/{modelId}

Daten eines Dienstes aktualisieren.

Empfehlung
Es ist ratsam, festzulegen, welches System für jede Datenart führend ist. Die API sollte Informationen synchronisieren und keine Konflikte zwischen Quellen erzeugen.

6. Anbieter, Vereinbarungen, Dienste und SLAs verwalten

Geschäftsziel

Die Lieferantenverwaltung von GlobalSuite mit Einkaufswerkzeugen, TPRM, Due Diligence oder führenden Drittanbietersystemen integrieren.

Beispielszenario

Einkauf verwaltet die Lieferantenstammdaten, während GlobalSuite Risiken, Nachweise, Vereinbarungen, Kontakte, betroffene Dienste und Nachverfolgung verwaltet.

Empfohlener Ablauf

1) Lieferant suchen oder erstellen. 2) Kontakte und Vereinbarungen verwalten. 3) Dienste und SLAs zuordnen. 4) Dokumentation anhängen. 5) Nachverfolgung registrieren.

Vorteil für den Benutzer

Ermöglicht die Verbindung von Drittanbieter-Governance, Einkauf und operationellem Risiko, wodurch vermieden wird, dass Teams Lieferantendaten in separaten Silos pflegen.

Methode

Endpoint

Orientierende Nutzung

GET

/suppliers

Vorhandene Lieferanten abrufen.

POST

/suppliers

Einen Lieferanten erstellen.

PUT

/suppliers/{modelId}

Informationen des Lieferanten aktualisieren.

GET

/suppliers/{modelId}/agreements

Vereinbarungen des Lieferanten abrufen.

POST

/suppliers/{modelId}/contacts

Verbundene Kontakte erstellen.

POST

/suppliers/{modelId}/files

Dokumentation anhängen.

GET

/suppliers/{modelId}/services

Verbundene Dienste abrufen.

POST

/suppliers/{modelId}/slas

SLAs des Lieferanten erstellen.

POST

/suppliers/{modelId}/tracings

Nachverfolgungen oder Spuren registrieren.

Empfehlung
Bevor Lieferanten automatisch erstellt werden, sollten Duplizierungsregeln definiert werden: NIF/CIF, DUNS, normalisierter Name, Land, Unternehmensgruppe oder andere verfügbare Identifikatoren.

7. Nachweise und Compliance aus externen Repositories verwalten

Geschäftsziel

Automatisierung des Ladens oder Aktualisierens von Nachweisen und deren Zuordnung zu Kontrollen, Rollen oder verantwortlichen Mitarbeitern.

Beispielszenario

Ein Dokumentenrepository, ein Audit-Tool oder eine Compliance-Lösung generiert Nachweise, die mit in GlobalSuite verwalteten Kontrollen verknüpft werden müssen.

Empfohlener Ablauf

1) Nachweistypen abrufen. 2) Nachweis erstellen oder aktualisieren. 3) Dateien bei Bedarf anhängen. 4) Nachweis mit Kontrollen und Verantwortlichen verknüpfen. 5) Nachverfolgbarkeit und Berechtigungen überprüfen.

Vorteil für den Benutzer

Verbessert die Vorbereitung von Audits und reduziert den Verlust von Nachweisen, die in nicht verbundenen Ordnern oder Tools verstreut sind.

Methode

Endpoint

Orientierende Nutzung

GET

/evidenceTypes

Nachweistypen abrufen.

GET

/evidences

Vorhandene Nachweise suchen.

POST

/evidences

Einen Nachweis erstellen.

PUT

/evidences/{modelId}

Einen Nachweis aktualisieren.

POST

/evidences/{modelId}/files

Dateien an den Nachweis anhängen.

POST

/evidences/{modelId}/controls/{objectId}

Nachweis mit einer Kontrolle verknüpfen.

POST

/evidences/{modelId}/roles/{objectId}/employees/{employeeId}

Mitarbeiter Rollen zuweisen, die mit dem Nachweis verbunden sind.

Empfehlung
Die Integration sollte Berechtigungen, Dokumentensensibilität und Kriterien für die Gültigkeit von Nachweisen respektieren.

8. Benutzer, Mitarbeiter und Rollen abgestimmt halten

Geschäftsziel

Sicherstellen, dass die in GlobalSuite verwendeten Personen und Rollen mit den Unternehmensquellen für Identität oder Personalressourcen abgestimmt sind.

Beispielszenario

HR oder IAM verwaltet Einstellungen, Entlassungen und Änderungen von Mitarbeitern. GlobalSuite benötigt diese Daten für Verantwortliche, Berechtigungen, Filter, Genehmigungen oder Zuweisungen in Funktionsmodulen.

Empfohlener Ablauf

1) Vorhandene Mitarbeiter und Benutzer abrufen. 2) Datensätze erstellen oder aktualisieren. 3) Rollen und Zuweisungen überprüfen. 4) Entlassungen kontrolliert verwalten.

Vorteil für den Benutzer

Vermeidet Diskrepanzen zwischen realen Personen, funktionalen Verantwortlichen und in GlobalSuite registrierten Benutzern.

Methode

Endpoint

Orientierende Nutzung

GET

/users

Anwendung Benutzer abfragen.

POST

/users

Benutzer erstellen, wenn der definierte Ablauf dies zulässt.

PUT

/users/{modelId}

Benutzerdaten aktualisieren.

GET

/employees

Mitarbeiter abfragen.

POST

/employees

Mitarbeiter erstellen.

PUT

/employees/{modelId}

Mitarbeiterdaten aktualisieren.

GET

/configRoles

Konfigurierte Rollen abfragen.

Empfehlung
Wenn SCIM oder ein anderer Identitätsfluss verwendet wird, sollte die API als Ergänzung und nicht als paralleler Mechanismus betrachtet werden, der Inkonsistenzen erzeugt.

Empfohlenes Design einer Integration

Um von einem Anwendungsfall zu einer stabilen Integration zu gelangen, wird ein inkrementeller Ansatz empfohlen:

  1. Das funktionale Ziel definieren: Welche Daten abgefragt, erstellt, aktualisiert oder verknüpft werden sollen und warum sie dem Prozess einen Mehrwert bieten.

  2. Das Master-System für jede Datenart identifizieren: Zum Beispiel CMDB für technische Assets, Einkauf für Lieferanten oder IAM für Benutzer.

  3. Das Modell in Swagger überprüfen: Pflichtfelder, Parameter, Antwortbeispiele, Fehler und verfügbare Beziehungen.

  4. Das Daten-Mapping vorbereiten: Entsprechungen zwischen Feldern des Quellsystems und Feldern von GlobalSuite, einschließlich Katalogen, Dimensionen und konfigurierbaren Werten.

  5. Berechtigungen und Umfang des API-Schlüssels validieren: Einheit, Untereinheit, Gültigkeit, erlaubte Operationen und sichtbare Daten.

  6. Mit einem reduzierten Teilset testen: Wenige Datensätze, Demo-Umgebung und funktionale Validierung durch Schlüsselbenutzer.

  7. Technische Kontrollen einbauen: Paginierung, Wiederholungen, Behandlung von Fehlern 403/429, Logs und Integrationswarnungen.

  8. Die Integration dokumentieren: Verantwortlicher, Häufigkeit, verwendete Endpunkte, Regeln zur Duplikatsvermeidung, Master-System und Verfahren bei Fehlern.

Empfohlenes Muster
Bei Integrationen mit hoher Kritikalität zuerst GET verwenden, um den aktuellen Zustand zu validieren, dann POST nur, wenn der Datensatz nicht existiert, und PUT nur, wenn der Ziel-Datensatz bestätigt wurde. Dieses Muster reduziert Duplikate und unerwünschte Aktualisierungen.

Best Practices für die Nutzung

Praxis

Warum es wichtig ist

Ein API-Schlüssel pro Integration

Erleichtert die Nachverfolgbarkeit, Widerrufung und Kontrolle von Limits. Vermeidet die Wiederverwendung desselben Schlüssels für Prozesse mit unterschiedlichen Zwecken.

Regelmäßige Schlüsselrotation

Erneuerung vor Ablaufdatum planen, um Unterbrechungen zu vermeiden.

Rate-Limit-Kontrolle

Anrufe gruppieren, korrekt paginieren und Batch-Prozesse zeitlich verteilen, um nicht mehr als 180 Anrufe pro Minute pro API-Schlüssel zu überschreiten.

DELETE nicht automatisieren ohne Validierung

Löschungen oder Disassoziationen sollten zusätzliche Kontrollen oder Genehmigungsflüsse erfordern.

Nachverfolgbarkeit registrieren

In Logs speichern, was gesendet wurde, wann, über welchen Endpunkt und welche Antwort erhalten wurde.

Regeln zur Duplikatsvermeidung entwerfen

Vor der Erstellung von Datensätzen nach Übereinstimmungen anhand funktionaler Identifikatoren suchen.

Kataloge und Konfiguration validieren

Nicht davon ausgehen, dass Kategorien, Felder, Dimensionen oder Tickettypen bei allen Kunden gleich sind.

Geschäftsfehler verwalten

Unterscheidung zwischen Authentifizierungsfehlern, Berechtigungen, Limits, Datenvalidierung und nicht gefundenen Ressourcen.

Karte der funktionalen Bereiche und Endpunkte

Die folgende Tabelle fasst die in der kommerziellen Anleitung identifizierten funktionalen Bereiche zusammen und zeigt Beispiele für Endpunkte, die in Swagger überprüft werden können. Es ist kein erschöpfender Katalog von Parametern oder Antworten.

Funktionaler Bereich

Anz. Ops.

Beispiele für Endpunkte

Benutzer und Kontosicherheit

5

GET /users, POST /users, GET /users/{modelId}, DELETE /users/{modelId}...

Tickets

28

GET /tickets, POST /tickets, GET /tickets/{modelId}, PUT /tickets/{modelId}...

Assets (Inventar)

32

GET /assetAttributes, GET /assetAttributes/{modelId}, GET /assets, POST /assets...

Risikoanalyse

23

GET /analysis/{modelId}/assets, POST /analysis/{modelId}/assets/{assetId}/controls/{controlId}/calculateRequest, POST /analysis/{modelId}/assets/{assetId}/threats/{threatId}/calculateRequest, GET /analysis/{modelId}/assets/{assetId}/threats/{threatId}/controls...

BIA, Umfragen und Auswirkungen Berechnungen

3

POST /calculateAccumulatedMtpd, POST /calculateImpactedMtpd, POST /calculateImpactedRto

Prozesse, Dienstleistungen und Konsolidierung

12

GET /processes, GET /processes/{modelId}, GET /processes/{modelId}/employees, GET /processes/{modelId}/inputActionOutput...

Mitarbeiter und Rollen

12

GET /configRoles, GET /employees, POST /employees, GET /employees/{modelId}...

Unternehmen

5

POST /companies/copyCompany, GET /companies/{modelId}/analysis, PUT /companies/{modelId}/analysis, GET /companies/{modelId}/roles...

ENS-Konformität und Bewertungen

17

PUT /controls/{modelId}, GET /evidenceTypes, GET /evidences, POST /evidences...

Dashboards

1

GET /dashboard/{modelId}/updatedDate/{objectId}

Berichte, Metriken und Projekte

1

DELETE /testplans/{modelId}/processes/{objectId}

Lieferanten

30

GET /suppliers, POST /suppliers, PUT /suppliers/{modelId}, GET /suppliers/{modelId}...

Kataloge und Risikobaum

1

GET /risks

Konfiguration, Methodik und Regeln

11

GET /connectionsPrefixes, GET /controlLevels, GET /controlLevels/{modelId}, GET /methodologies/{modelId}...

Hilfe und Referenzen

  • Die Swagger-Dokumentation sollte die endgültige Referenz für Pflichtparameter, Struktur des Anfragekörpers, Antworten und Fehler sein.

  • Vor der Nutzung der API sollte das GlobalSuite-Benutzerhandbuch überprüft werden, um die funktionale Logik des zu integrierenden Moduls zu verstehen.

  • Wenn ein Endpunkt nicht wie erwartet antwortet, zuerst API-Schlüssel, Umgebung, Einheit/Untereinheit, Berechtigungen, Rate-Limit und Testdaten validieren.

  • Bei Fragen oder Problemen die Anfrage über den Anbieter oder das GlobalSuite-Kundensupportzentrum kanalisieren.

Referenzlinks:

Swagger-Demo Europa

GlobalSuite-Benutzerhandbuch

GlobalSuite-Changelog