Справочник Роли содержит информацию о ролях клиента (имя) системы TrackControl Web 2, доступных для назначения их пользователям и настройкой на них прав.
...
Чтобы получить список всех ролей, необходимо отправить GET запрос на адрес https://teletrack.ua/api/v2/<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": |
...
...
...
Управляющая организация"
},
"Organization": {
|
...
...
...
ТОВ"
}
}
],
"Description": "демо",
"Id": |
...
1057,
"IsReadOnly": false,
"Name": |
...
"Переглядач",
"OrganizationId": 70,
"mainorganizationid": 2605
}
],
|
...
...
Создание новой записи
Для создания новой записи (новой роли), необходимо отправить POST запрос на адрес https://teletrack.ua/api/v2/<token>/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 * |
| mainorganizationidDeparts | Список организаций, к которым предоставляется доступ * |
| MainOrganization | ID управляющей организации в БД * |
| OrganizationIdOrganization | ID организации в БД; 0null, если отсутствует * |
| DepartIdDepartment | ID департамента в БД; 0null, если отсутствует * |
* - обязательный параметр
В случае успешного выполнения запроса, должен прийти ответ следующего вида:
| Code Block |
|---|
|
{
"data": {
"Id": |
...
19
},
"err": null,
"status": true
} |
Редактирование записи (роли)
Для редактирования существующей записи нужно отправить PUT запрос на адрес https://teletrack.ua/api/v2/<token>/usersroles/<Id><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 записи Id роли в БД * |
| Name | Название роли * |
| Descr | Описание роли * |
| IsReadOnly | Роль только для чтения - true / false * |
| Departs | Список организаций, к которым предоставляется доступ * |
| mainorganizationidMainOrganization | ID управляющей организации в БД * |
| OrganizationIdOrganization | ID организации в БД; 0null, если отсутствует * |
| DepartIdDepartment | ID департамента в БД; 0null, если отсутствует * |
* - обязательный параметр
В случае успешного выполнения запроса, должен прийти ответ следующего вида:
| Code Block |
|---|
|
{
"data": null,
"err": null,
"status": true
} |
Удаление записи (роли)
Для удаления существующей записи нужно отправить DELETE запрос на адрес https://teletrack.ua/api/v2/<token>/usersroles/<Id>, где
| token | Токен получен при авторизации * |
| Id | ID записи (роли) в БД которою нужно удалить * |
* - обязательный параметр
В случае успешного выполнения запроса, должен прийти ответ следующего вида:
| Code Block |
|---|
|
{
"data": null,
"err": null,
"status": true
} |