API-Methoden für die Gruppenverwaltung

REST API-Methoden zum Verwalten von Gruppen, einschließlich Erstellen, Aktualisieren, Auflisten und Löschen von Gruppen.

Eine Gruppe erstellen

Eine POST-Methode zum Erstellen einer neuen Benutzergruppe.

Anfrage

POST /api/v1/groups/

Beispielanfragetext

 {
    "name" : <string>,
    "description" : <string_may_be_null>,
 }

Antwort

  {
    "groupId" : <integer>,
    "pid" : <integer>,
    "name" : <string>,
    "description" : <string_may_be_null>,
    "membershipCount" : <integer>,
    "wildcards" : <list of strings>,
    "users" : <list of user IDs>
  }

Gruppe aktualisieren

Eine PUT-Methode zum Aktualisieren einer Benutzergruppe.

Anfrage

PUT /api/v1/groups/<groupId>

Beispielanfragetext

 {
    "name" : <string>,
    "description" : <string_may_be_null>,
 }

Antwort

  {
    "groupId" : <integer>,
    "pid" : <integer>,
    "name" : <string>,
    "description" : <string_may_be_null>,
    "membershipCount" : <integer>,
    "wildcards" : <list of strings>,
    "users" : <list of user IDs>
  }

Listengruppen

Eine GET-Methode zur Auflistung von Benutzergruppen.

Anfrage

GET /api/v1/groups/

Antwort

[
  { 
    "groupId" : <integer>,
    "pid" : <integer>,
    "name" : <string>,
    "description" : <string_may_be_null>,
    "membershipCount" : <integer>,
    "wildcards" : <list of strings>,
    "users" : <list of user IDs>
  }, ...
]

Eine Gruppe löschen

Eine DELETE-Methode zum Löschen einer Benutzergruppe und zum Entfernen aller Mitglieder aus dieser Gruppe.

Anfrage

DELETE /api/v1/groups/<groupId>

Gibt 204 No Content zurück, falls erfolgreich. Im Falle eines Konflikts wird 409 Conflict zurückgegeben.

Gruppen stapelweise löschen

Eine DELETE-Methode zum Löschen mehrerer Gruppen in großen Mengen und zum Entfernen aller Mitglieder aus dieser Gruppe.

Anfrage

DELETE /api/v1/groups/bulk-delete

Gibt 204 No Content zurück, falls erfolgreich. Im Falle eines Konflikts wird 409 Conflict zurückgegeben.

Alle Berechtigungen für eine Gruppe auflisten

Eine GET-Methode zum Auflisten der Berechtigungsobjekte einer Gruppe.

Anfrage

GET /api/v1/groups/{groupId}/permissions

Antwort

[{
 "objectId" : 34,
 "objectType": "SEGMENT",
 "permissions": ["READ", "WRITE", "DELETE", "MAP_TO_MODELS"]
 },

{
 "objectId" : "234",
 "objectType": "TRAIT",
 "permissions": ["READ", "WRITE", "DELETE", "MAP_TO_MODELS"]
 },
 {
 "objectId" : 277,
 "objectType": "SEGMENT",
 "permissions": ["READ", "WRITE", "MAP_TO_MODELS"]
 }
]

Gibt 400 Bad Request zurück, wenn auf die Gruppe nicht zugegriffen werden kann.

Festlegen von Berechtigungen für eine Gruppe

Eine PUT-Methode zum Aktualisieren von Gruppenberechtigungen. Diese Methode überschreibt die alten Berechtigungen mit den neuen Berechtigungen.

Anfrage

PUT /api/v1/groups/{groupId}/permissions/

Antwort

[ 
  { "objectType" : "SEGMENT",
    "objectId" : 563,
    "permissions" : [ "READ", "WRITE"]
  },
  { "objectType" : "SEGMENT",
    "objectId" : 2363,
    "permissions" : [ "CREATE", "WRITE"]
  },
  { "objectType" : "TRAIT",
    "objectId" : 83498,
    "permissions" : [ "READ", "MAP_TO_SEGMENTS"]
  },
  { "objectType" : "DESTINATION",
    "objectId" : 304,
    "permissions" : [ "READ", "WRITE", "CREATE"]
  }
]

Die Beispielantwort stellt die aktualisierte Liste der Berechtigungsobjekte dar.

Gibt 200 OK zurück, falls erfolgreich. Gibt 400 zurück, wenn eine gegebene Berechtigung ungültig ist. Kann auch 403 zurückgeben, wenn der angemeldete Benutzer nicht auf das Objekt zugreifen kann.