Роли API

Справочник Роли содержит информацию о ролях клиента (имя) системы TrackControl Web 2, доступных для назначения их пользователям и настройкой на них прав.

Получение данных

Чтобы получить список всех ролей, необходимо отправить GET запрос на адрес https://teletrack.ua/api/v2/<token>/usersroles/, где

token

Токен получен при авторизации *

* - обязательный параметр

В случае успешного выполнения запроса, должен прийти ответ со списком ролей следующего формата:

{
  "data": [
    {
      "Description": "Admin role", 
      "Id": 43, 
      "Name": "admin"
    },
    {
      "Description": "test1 desc", 
      "Id": 58, 
      "Name": "test1"
    }
  ], 
  "err": null, 
  "status": true
}

Создание новой записи

Для создания новой записи (новой роли), необходимо отправить POST запрос на адрес https://teletrack.ua/api/v2/<token>/usersroles/, где

token	Токен получен при авторизации *
Name	Название роли *
Descr	Описание роли *
IsReadOnly	Роль только для чтения - true / false *
mainorganizationid	ID управляющей организации в БД *
OrganizationId	ID организации в БД; 0, если отсутствует *
DepartId	ID департамента в БД; 0, если отсутствует *

* - обязательный параметр

В случае успешного выполнения запроса, должен прийти ответ следующего вида:

{
  "data": {
    "Id": 183
  }, 
  "err": null, 
  "status": true
}

Id	`ID новой записи в БД`

Редактирование записи (роли)

Для редактирования существующей записи нужно отправить PUT запрос на адрес https://teletrack.ua/api/v2/<token>/usersroles/<Id>, где

token	Токен получен при авторизации *
Id	`ID записи в БД *`
Name	Название роли *
Descr	Описание роли *
IsReadOnly	Роль только для чтения - true / false *
mainorganizationid	ID управляющей организации в БД *
OrganizationId	ID организации в БД; 0, если отсутствует *
DepartId	ID департамента в БД; 0, если отсутствует *

* - обязательный параметр

В случае успешного выполнения запроса, должен прийти ответ следующего вида:

{
  "data": null, 
  "err": null, 
  "status": true
}

Удаление записи (роли)

Для удаления существующей записи нужно отправить DELETE запрос на адрес https://teletrack.ua/api/v2/<token>/usersroles/<Id>, где

token	Токен получен при авторизации *
Id	`ID записи (роли) в БД которою нужно удалить *`

* - обязательный параметр

В случае успешного выполнения запроса, должен прийти ответ следующего вида:

{
  "data": null, 
  "err": null, 
  "status": true
}