Сотрудники¶
Получить список всех сотрудников аккаунта¶
GET /v1.3/managers
После успешного выполнения возвращается массив объектов, описывающих сотрудников.
id | integer | Идентификатор сотрудника |
name | string | Название организации или имя пользователя |
login | string | Email сотрудника |
role | string | Роль сотрудника в системе: owner (владелец) или manager (менеджер) |
confirmed | bool | Флаг, отображающий подтвержден ли аккаунт |
allowAllDeals | bool | Флаг, отображающий есть ли доступ к обращениям всех операторов в рамках доступных интеграций |
sources | массив объектов | Массив доступов к подключенным интеграциям (Если пустой, значит доступны все) |
|
integer | Идентификатор записи о доступе к интеграции |
|
integer | Идентификатор интеграции (Если null, значит все не доступны) |
Пример:
GET https://api.umnico.com/v1.3/managers
Response:
[
{
"id": 15,
"login": "first-manager@company.com",
"name": "Первый менеджер",
"role": "owner",
"confirmed": true,
"allowAllDeals": false,
"allowedUsers": null,
"sources": []
},
{
"id": 18,
"login": "second-manager@company.com",
"name": "Второй менеджер",
"role": "manager",
"confirmed": true,
"allowAllDeals": false,
"allowedUsers": null,
"sources": [
{
"id": 27,
"saId": 13
}
]
},
]
Добавить сотрудника¶
POST /v1.3/managers
Тело запроса:
- login - email, на который придет приглашение для регистрации в Umnico
- sources - массив объектов - массив доступов к подключенным интеграциям (если пустой, значит доступны все)
- saId - идентификатор интеграции
Если передать одну единственную запись в массиве доступов, где saId = null, то таким образом менеджеру становятся недоступны все аккаунты. После успешного выполнения возвращается массив объектов, описывающих сотрудников (см. выше).
Пример:
POST https://api.umnico.com/v1.3/managers
Body:
{
"login": "ggg@aaa.com",
"sources": [
{
"saId": null
}
]
}
Response:
[
{
"id": 15,
"login": "first-manager@company.com",
"name": "Первый менеджер",
"role": "owner",
"confirmed": true,
"allowAllDeals": false,
"allowedUsers": null
},
{
"id": 18,
"login": "second-manager@company.com",
"name": "Второй менеджер",
"role": "manager",
"confirmed": true,
"allowAllDeals": false,
"allowedUsers": null
},
{
"id": 20,
"login": "third-manager@company.com",
"name": null,
"role": "manager",
"confirmed": false,
"allowAllDeals": false,
"allowedUsers": null
},
]
Изменить доступы к подключенным интеграциям¶
PUT /v1.3/managers/<id>
- id - идентификатор сотрудника
Тело запроса:
- sources - массив объектов - массив доступов к подключенным интеграциям (если пустой, значит доступны все)
- id - идентификатор записи о доступе к интеграции
- saId - идентификатор интеграции
Пример:
PUT https://api.umnico.com/v1.3/managers/18
Body:
{
"sources":
[
{
"id": 27,
"saId": 13
},
{
"saId": 75
}
]
}
Response: status 200
Изменить доступ менеджера к сделкам других менеджеров аккаунта¶
PUT /v1.3/managers/users-access/<id>
- id - идентификатор сотрудника
Тело запроса:
- allowedUsers - массив идентификаторов - массив идентификаторов сотрудников, к которым текущий сотрудник имеет доступ (если массив пустой, значит нет доступа к сделкам других менеджеров)
- id - идентификатор сотрудника к сделкам которого предоставляется доступ (например: [1, 2, 3])
Примечание
Массив переписывается каждый раз при вызове метода, например, если вы вызвали метод, передав [1, 2, 3], а следом - [1], то конечным результатом будет [1].
Пример:
PUT https://api.umnico.com/v1.3/managers/users-access/18
Body:
{
"allowedUsers": [15]
}
Response: status 200
Удалить сотрудника¶
DELETE /v1.3/managers/<id>
- id - идентификатор сотрудника
Пример:
DELETE https://api.umnico.com/v1.3/managers/20
Response: status 200