Der Aufbau der generellen Route für die Berechtigungsprofile sieht wie folgt aus:
https://ws.etracker.com/api/v6/subuserPublic/role
Profil abfragen
Um bestehende Berechtigungsprofile in deinem Account abzufragen, kannst du einen GET-Request absetzen. Zur Veranschaulichung dient das folgende Curl-Beispiel:
curl 'https://ws.etracker.com/api/v6/subuserPublic/role' -X GET -H 'X-ET-email: qa@etracker.com' -H 'X-ET-developerToken: ab7891ca89d9b4d10dc1703a7f0214256babe6c9' -H 'X-ET-accountId: 18854' -H 'X-ET-password: demo'
Als Antwort des GET-Requests erhältst du:
[[{"id":"7","name":"Lese- und Schreibrechte","version":"1","users":"1"},{"id":"5","name":"Leserechte","version":"1","users":"2"}]]
Profil anlegen
Folgendes Curl-Beispiel zeigt das Anlegen eines Berechtigungsprofils, das den Zugriff auf zwei Mitbenutzer gewährt:
curl 'https://ws.etracker.com/api/v6/subuserPublic/role' -X POST -H 'X-ET-email: qa@etracker.com' -H 'X-ET-developerToken: ab7891ca89d9b4d10dc1703a7f0214256babe6c9' -H 'X-ET-accountId: 18854' -H 'X-ET-password: demo' --data 'name=Test&role_type=admin&multi_client_access_mode=custom&multi_clients_selection%5B%5D=18855&multi_clients_selection%5B%5D=260960'
Die in dem Parameter „–data“ enthaltenen Informationen sind:
nme = Frei wählbarer Name des Berechtigungsprofils, muss eindeutig sein
role_type = Lese -und Schreibrechte oder nur Leserechte. Werte können sein: read_only oder admin
multi_client_access_mode = Festlegen, ob mit diesem Berechtigungsprofil auf Multimandanten zugegriffen werden kann. Werte können sein: none, all oder custom.
multi_clients_selection = Angabe des Multimandanten, auf den der Zugriff erlaubt wird. Es kann mehr als ein Multimandant angegeben werden.
Wichtiger Hinweis: In dem Parameter „–data“ müssen folgende Informationen immer enthalten sein: name, role_type und multi_client_access_mode
Wird dem multi_client_access_mode der Wert „custom“ zugewiesen, so müssen über die multi_clients_selection die entsprechenden Accounts (Multimandanten) gesetzt werden (siehe Curl-Beispiel).
Profil löschen
Der Aufbau der Route zum Löschen eines Berechtigungsprofils sieht wie folgt aus:
https://ws.etracker.com/api/v6/subuserPublic/role/<roleId>
Folgender Curl zeigt einen DELETE-Request, der das Profil mit der ID 7 löscht:
curl 'https://ws.etracker.com/api/v6/subuserPublic/role/7' -X DELETE -H 'X-ET-email: qa@etracker.com' -H 'X-ET-developerToken: ab7891ca89d9b4d10dc1703a7f0214256babe6c9' -H 'X-ET-accountId: 18854' -H 'X-ET-password: demo'
Hinweis: Die zur Verfügung stehenden „roleIds“ können mit einem GET- Request abgefragt werden (siehe Curl-Beispiel Profil abfragen). Ist ein Berechtigungsprofil einem Mitbenutzer zugewiesen, kann dieses nicht gelöscht werden!