Die REST-API verwenden
15. April 2024
ID 204471
Im Rahmen von MDR ermöglicht die REST-API das Abrufen, Erstellen und Aktualisieren von Assets, Vorfällen, Reaktionen und Benutzern.
Die REST-API-Methoden erfordern einen Wert für die client_id
. Sie können den Wert Ihrer client_id
im Block Token-Info eines beliebigen Aktualisierungstokens in der MDR Web Console abrufen.
Im Folgenden sind Beispiele für Python- und Shell-Skripte aufgeführt, welche die Kernfunktionen der REST-API veranschaulichen:
- Zertifikatspfad, REST-API-URL, Client-ID und Token definieren
- Zugriffstoken und Aktualisierungstoken für das nächste Update des Zugriffstokens abrufen
- Anzahl der Assets abrufen
- Asset-Liste oder Asset-Details abrufen
- Anzahl der Vorfälle, der Vorfall-Liste, oder von Vorfalls-Details abrufen
- Reaktions-Liste für einen Vorfall abrufen
- Reaktionen bestätigen, ablehnen oder die Reaktions-Liste aktualisieren
- Liste an Kommentaren für den angegebenen Vorfall abrufen oder einen neuen Kommentar für den angegebenen Vorfall erstellen
Beispiel (Python):
|
Beispiel (Shell):
|
Beispiel einer REST-API-Antwort mit Zugriffstoken und neuem Aktualisierungstoken:
{
"access_token": "SamPLET346yoKEnSamPLEToK25EnSamPLEToK35EnS",
"refresh_token": "tOKenSaMPlet259OKenS123aMPle926tOKenSaMPle"
}
Beispiel einer REST-API-Antwort mit Struktur und Werten von Kommentaren:
[{
"comment_id": "bfu6TiNghqp",
"author_name": "Jona Luca Schmidt",
"text": "<p>
Der erste Kommentar.
</p>",
"creation_time": 1601295428640
}, {
"comment_id": "bfu6TiNghqt",
"author_name": "Max Mustermann",
"text": "<p>
Der zweite Kommentar.
</p>",
"creation_time": 1601295433441
}]
Beispiel einer REST-API-Antwort, wenn die REST-API einen neuen Kommentar erstellt und eine Antwort mit Kommentardetails liefert:
{
"comment_id": "AXTej0Qi4bfu6TiNgmvT",
"author_name": "Tokenname",
"text": "
Dieser neue Kommentar wurde mit der REST API erstellt.
",
"creation_time": 1601461748122
}