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
|
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
|
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
|
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
|
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
|
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
|
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
|
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
|
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
|
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
|
Empfohlenes Design einer Integration
Um von einem Anwendungsfall zu einer stabilen Integration zu gelangen, wird ein inkrementeller Ansatz empfohlen:
-
Das funktionale Ziel definieren: Welche Daten abgefragt, erstellt, aktualisiert oder verknüpft werden sollen und warum sie dem Prozess einen Mehrwert bieten.
-
Das Master-System für jede Datenart identifizieren: Zum Beispiel CMDB für technische Assets, Einkauf für Lieferanten oder IAM für Benutzer.
-
Das Modell in Swagger überprüfen: Pflichtfelder, Parameter, Antwortbeispiele, Fehler und verfügbare Beziehungen.
-
Das Daten-Mapping vorbereiten: Entsprechungen zwischen Feldern des Quellsystems und Feldern von GlobalSuite, einschließlich Katalogen, Dimensionen und konfigurierbaren Werten.
-
Berechtigungen und Umfang des API-Schlüssels validieren: Einheit, Untereinheit, Gültigkeit, erlaubte Operationen und sichtbare Daten.
-
Mit einem reduzierten Teilset testen: Wenige Datensätze, Demo-Umgebung und funktionale Validierung durch Schlüsselbenutzer.
-
Technische Kontrollen einbauen: Paginierung, Wiederholungen, Behandlung von Fehlern 403/429, Logs und Integrationswarnungen.
-
Die Integration dokumentieren: Verantwortlicher, Häufigkeit, verwendete Endpunkte, Regeln zur Duplikatsvermeidung, Master-System und Verfahren bei Fehlern.
|
Empfohlenes Muster
|
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: