Rufen Sie die ID eines Benutzers oder einer Gruppe über die Learn365 API ab

Aus bestimmten Gründen müssen Sie möglicherweise die ID eines bestimmten Benutzers oder einer bestimmten Gruppe abrufen; der Learn365 API-Endpunkt kann Ihnen dabei helfen. In diesem Artikel wird beschrieben, welche API in Swagger verwendet werden soll und welche Aktionen auszuführen sind.

Um die ID eines bestimmten Benutzers oder einer bestimmten Gruppe abzurufen, gehen Sie wie folgt vor:

1. Gehen Sie zu https://api.365.systems/ und vergewissern Sie sich, dass Sie mit dem entsprechenden API-Schlüssel autorisiert sind.

2. Suchen Sie den Users Abschnitt, erweitern Sie ihn, suchen Sie die GET-Methode /odata/v2/Users mit der Beschreibung Return the list of Users und wählen Sie dann oben rechts Try it out aus.

Sie können Abfrageoptionsparameter verwenden, um die Daten in der Antwort durch das Festlegen von Filtern zu steuern. Wenn Abfrageoptionsparameter festgelegt sind, enthält die Antwort zusätzliche Daten und Details, die Sie für die Suche verwenden können.

Sie können beispielsweise die E-Mail-Adresse des betreffenden Benutzers verwenden, um die Antwort einzugrenzen. Geben Sie dazu im Feld $filter Folgendes ein: Email eq 'E-Mail-Adresse'

3. Wählen Sie Execute aus, um die Anfrage auszuführen.

4. Gehen Sie zum Block Responses , um die Ergebnisse zu überprüfen:

• Die Zahl 2xx (beispielsweise „200“) unter Code zeigt an, dass die Anfrage korrekt funktioniert hat.
• Im Feld Response body sehen Sie, wenn keine Abfrageoptionsparameter festgelegt sind, die Liste der Benutzer und Gruppen aller Kurskataloge des Tenant und ihre Daten einschließlich der ID. Wenn Abfrageoptionsparameter festgelegt sind, enthält die Antwort nur die relevanten Daten und Details.
• Sie können per Ctrl+F nach der ID eines bestimmten Benutzers oder einer bestimmten Gruppe suchen und sie kopieren, um sie überall dort zu verwenden, wo Sie sie benötigen. Außerdem können Sie die Option Download verwenden, um die Ergebnisse der API-Anfrage im .JSON-Format auf Ihrem Computer zu speichern.
  Der Parameter PrincipleType in der Antwort gibt an, ob es sich um einen Benutzer oder eine Gruppe handelt.

Beispiel für die ID einer Gruppe.

Beispiel für die ID eines Benutzers.