Integration & Setup

  1. Home
  2. Integration & Setup
  3. Entwickler APIs
  4. Verwaltung Berechtigungsprofile & Mitbenutzer
  5. Berechtigungsprofile verwalten

Berechtigungsprofile verwalten

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 Ihrem Account abzufragen, können Sie 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 erhalten Sie dann:

[[{"id":"7","name":"Lese- und Schreibrechte","version":"1","users":"1"},{"id":"5","name":"Leserechte","version":"1","users":"2"}]]

Profil anlegen

Folgendes Curl-Beispiel zeigt Ihnen 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 nur einer 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 „roleId’s“ 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!