Seit Kurzem unterstützt die Studytube-API das Einrichten von teamspezifischen Berechtigungen für Benutzer. Damit kannst du pro Team festlegen, welche Rechte ein Benutzer erhält, wie zum Beispiel das Verwalten von Benutzerdaten oder das Einsehen untergeordneter Teams.
Diese Funktion ist nützlich für Organisationen, die beim Erstellen oder Aktualisieren von Benutzern über die API automatisch Rollen zuweisen möchten.
Was sind Team-Berechtigungen?
Team-Berechtigungen sind Rechte, die festlegen, was ein Benutzer innerhalb eines bestimmten Teams tun darf. Du legst diese Rechte fest, wenn du einen Benutzer über die API hinzufügst oder aktualisierst.
Jede Berechtigung ist ein boolescher Wert (true oder false), der explizit pro Team mitgegeben werden muss.
Verfügbare Berechtigungen
| Berechtigung | Beschreibung |
|---|---|
access_subteams |
Gibt dem Benutzer Zugriff auf untergeordnete (Sub-)Teams |
manage_user_data |
Benutzer darf Teammitglieder verwalten (z. B. bearbeiten oder deaktivieren) |
manage_user_learnings_content |
Darf Lernaktivitäten innerhalb des Teams verwalten |
manage_user_qualifications |
Darf Qualifikationen von Teammitgliedern verwalten |
view_user_data |
Darf Daten von Teammitgliedern einsehen |
Hinweis: Alle Felder sind verpflichtend im API-Aufruf. Du musst also bei jeder Berechtigung true oder false mitgeben — auch wenn du keine Rechte zuweisen möchtest.
Beispiel eines JSON-Payloads
Im Folgenden siehst du ein Beispiel, wie du Team-Berechtigungen in einer POST- oder PATCH-Anfrage an den Benutzer-Endpunkt mitsendest:
{
"email": "user@example.com",
"first_name": "Anna",
"last_name": "Jansen",
"teams": [
{
"id": 12345,
"team_permissions": {
"access_subteams": true,
"manage_user_data": false,
"manage_user_learnings_content": true,
"manage_user_qualifications": false,
"view_user_data": true
}
}
]
}
Häufig gestellte Fragen
Sind alle Berechtigungen verpflichtend?
Ja, du musst alle fünf Felder explizit mitgeben — auch wenn du false verwendest.
Was passiert, wenn du nichts ausfüllst?
Der API-Aufruf schlägt fehl, da alle fünf Berechtigungen als erforderlich eingestellt sind.
Kann ich mehrere Teams mit unterschiedlichen Rechten einrichten?
Ja, du kannst mehrere Team-Blöcke zum teams-Array hinzufügen, jeweils mit eigenen Berechtigungen.
Fragen oder Hilfe benötigt?
Hast du Fragen zur Verwendung von Team-Berechtigungen in der API, oder stößt du auf Fehlermeldungen? Wende dich gerne an support@studytube.de. Wir helfen dir gerne weiter.