Справочник Роли содержит информацию о ролях клиента (имя) системы TrackControl Web 2, доступных для назначения их пользователям и настройкой на них прав.
...
Получение данных
Чтобы получить список всех ролей, необходимо отправить GET запрос на адрес httphttps://teletrack.ua/api/usersrolesv2/getAll<token>/<token>usersroles/, где
| token | Токен получен при авторизации * |
* - обязательный параметр
В случае успешного выполнения запроса, должен прийти ответ со списком ролей следующего формата:
| Code Block | ||
|---|---|---|
| ||
{ "data": [ { "DepartId": null, "Departs": [ { "Department": { "id": null, "name": null }, "MainOrganization": { "id": 341, "name": "Агро ТОВ (упр)" }, "Organization": { "id": null, "name": null } } ], "Description": "Администратор", "Id": 84, "IsReadOnly": false, "Name": "Admin |
...
", "OrganizationId": null, "mainorganizationid": 341 }, ... ... { "DepartId": 106, "Departs": [ { "Department": { "id": 16, "name": "Інженерний відділ" }, |
...
"MainOrganization": { "id": |
...
2605, " |
...
name": " |
...
Управляющая организация" }, "Organization": { |
...
"id": 70, "name": " |
...
Организация |
...
ТОВ" } } ], "Description": "демо", "Id": |
...
1057, "IsReadOnly": false, "Name": " |
...
Переглядач", "OrganizationId": 70, "mainorganizationid": 2605 } ], |
...
"err": null,
|
...
"status": true
} |
Создание новой записи
Для создания новой записи (новой роли), необходимо отправить GET POST запрос на адрес httphttps://teletrack.ua/api/usersrolesv2/save<token>/<token>/?id=0&name=Test%20name&descr=Test%20desc , где
...
usersroles/ c параметрами в формате JSON
| Code Block | ||
|---|---|---|
| ||
{
"Name":"test",
"Descr":"test_role",
"IsReadOnly":false,
"Departs":
[
{"Department":{"id":176},"MainOrganization":{"id":319},"Organization":{"id":320}},
{"Department":{"id":null},"MainOrganization":{"id":51},"Organization":{"id":19}},
{"Department":{"id":null},"MainOrganization":{"id":18},"Organization":{"id":null}}
]
} |
, где
| token | Токен получен при авторизации * |
| Name | Название роли * |
| Descr | Описание роли * |
| IsReadOnly | Роль только для чтения - true / false * |
| Departs | Список организаций, к которым предоставляется доступ * |
| MainOrganization | ID управляющей организации в БД * |
| Organization | ID организации в БД; null, если отсутствует * |
| Department | ID департамента в БД; null, если отсутствует * |
* - обязательный параметр
В случае успешного выполнения запроса, должен прийти ответ следующего вида:
| Code Block | ||
|---|---|---|
| ||
{
"data": {
"Id": |
...
19 }, "err": null, "status": true } |
| Id | ID новой |
Редактирование записи (роли)
Для редактирования существующей записи нужно отправить GET PUT запрос на адрес httphttps://teletrack.ua/api/usersrolesv2/save/63974aa3-b39c-4ed5-9ec2-6bcf71d8fbee/?id=183&name=Test%20name&descr=Test%20desc , где
...
<token>/usersroles/<Id> c параметрами в формате JSON
| Code Block | ||
|---|---|---|
| ||
{
"Name":"test",
"Descr":"test_role",
"IsReadOnly":false,
"Departs":
[
{"Department":{"id":176},"MainOrganization":{"id":319},"Organization":{"id":320}},
{"Department":{"id":null},"MainOrganization":{"id":51},"Organization":{"id":19}},
{"Department":{"id":null},"MainOrganization":{"id":18},"Organization":{"id":null}}
]
} |
, где
| token | Токен получен при авторизации * |
| Id | Id роли в БД * |
| Name | Название роли * |
| Descr | Описание роли * |
| IsReadOnly | Роль только для чтения - true / false * |
| Departs | Список организаций, к которым предоставляется доступ * |
| MainOrganization | ID управляющей организации в БД * |
| Organization | ID организации в БД; null, если отсутствует * |
| Department | ID департамента в БД; null, если отсутствует * |
* - обязательный параметр
В случае успешного выполнения запроса, должен прийти ответ следующего вида:
| Code Block | ||
|---|---|---|
| ||
{
"data": null,
"err": null,
"status": true
} |
Удаление записи (роли)
Для удаления существующей записи нужно отправить GET запрос на адрес httpотправить DELETE запрос на адрес https://teletrack.ua/api/usersrolesv2/deleteById<token>/<token>/?id=183 гдеusersroles/<Id>, где
| token | Токен получен при авторизации * |
| Id | |
* - обязательный параметр
В случае успешного выполнения запроса, должен прийти ответ следующего вида:
| Code Block | ||
|---|---|---|
| ||
{
"data": null,
"err": null,
"status": true
} |