Mit der Learn365-API können Sie Flow365-Benutzerkonten deaktivieren oder aktivieren. Wenn Sie ein Benutzerkonto deaktivieren, kann sich der Benutzer nicht auf der Schulungsseite oder in der Learn365-Mobile-App anmelden, bis das Konto wieder aktiviert wird.
In diesem Artikel beschreiben wir die Schritte, die Sie ausführen sollten, um Flow365-Benutzerkonten per API zu deaktivieren oder zu aktivieren.
HINWEISE
- Standardmäßig sind neue Flow365-Benutzerkonten aktiviert.
- Wenn Sie ein Flow365-Benutzerkonto deaktivieren, wird das Benutzerkonto weiterhin zur Gesamtzahl der Flow365-Benutzer in Ihrem Abonnement gezählt.
Zum Deaktivieren oder Aktivieren eines Flow365-Benutzerkontos benötigen Sie die ID des betreffenden Benutzers. Sie können diese Information per API ermitteln, indem Sie die Schritte in diesem Artikel befolgen.
So deaktivieren oder aktivieren Sie ein Flow365-Benutzerkonto:
1. Gehen Sie zu https://api.365.systems/, und vergewissern Sie sich, dass Sie mit dem entsprechenden API-Schlüssel autorisiert sind.
2. Wählen Sie im Abschnitt Users eine dieser Anfragen aus:
-
POST /services/users/Users/{id}/Enable und POST /services/users/Users/{id}/Disable ermöglichen es Ihnen, ein bestimmtes Flow365-Benutzerkonto zu aktivieren oder zu deaktivieren. Wenn Sie eine dieser Anfragen auswählen, klicken Sie oben rechts auf Try it out und geben Sie im Feld id eine Benutzer-ID ein.
-
POST /services/users/Users/Enable und POST /services/users/Users/Disable ermöglichen es Ihnen, mehrere Flow365-Benutzerkonten mit einer einzigen Anfrage zu aktivieren oder zu deaktivieren. Wenn Sie eine dieser Anfragen auswählen, klicken Sie oben rechts auf Try it out und geben Sie die Benutzer-IDs im Array im Anfragetext ein.
3. Klicken Sie auf Execute, um die Anfrage auszuführen.
4. Gehen Sie zum Block Response, um die Ergebnisse zu kontrollieren. Für alle vier Anfragen sind die Ergebnisse gleich:
- 200 code mit einem leeren Antworttext weist auf eine erfolgreiche Antwort hin.
- 404 code mit einer Fehlerbeschreibung im Antworttext weist darauf hin, dass kein Benutzer mit dieser ID gefunden wurde. Überprüfen Sie die Benutzer-ID und versuchen Sie es erneut.
- Bei anderen Fehlern enthält der Antworttext das Objekt error mit den Schlüsseln code und message, die das Problem erklären.
Kommentare
Zu diesem Beitrag können keine Kommentare hinterlassen werden.