Berechtigungsprofile verwalten

Der Aufbau der generellen Route für die Berechtigungsprofile sieht wie folgt aus:

https://ws.etracker.com/api/rest/v3/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/rest/v3/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/rest/v3/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/rest/v3/subuserPublic/role/<roleId>

  Folgender Curl zeigt einen DELETE-Request, der das Profil mit der ID 7 löscht:

  curl 'https://ws.etracker.com/api/rest/v3/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!