История подключений
На этой странице вы найдете описания методов API, предназначенных для работы с данными о подключениях из раздела История подключений.
Список сессий¶
Чтобы получить историю ваших подключений, используйте метод history/list.
Запрос:
curl -G "https://api.pro32connect.ru/v1/history/list" \
--data-urlencode "agent_id=<number>" \
--data-urlencode "support_id=<number>" \
--data-urlencode "date_from=<unixtime>" \
--data-urlencode "date_to=<unixtime>" \
--data-urlencode "video=<boolean>" \
--data-urlencode "offset=<number>" \
--data-urlencode "limit=<number>" \
-H "X-Api-Key: YOUR_API_KEY" \
| Параметр | Тип | Значение |
|---|---|---|
agent_id | string | Фильтр по ID агента |
support_id | number | Фильтр по ID приглашения |
date_from | unixtime | Фильтр по дате и времени: начало периода |
date_to | unixtime | Фильтр по дате и времени: конец периода |
video | boolean | Фильтр по записи видео |
offset | number | Смещение для первого элемента в списке |
limit | number | Количество элементов в списке. Значение по умолчанию: 20; максимальное значение: 100 |
Ответ:
Пример ответа
Данные ответа
{
"offset": 0,
"limit": 10,
"total": 15,
"filter": {
"date_from": 1608660281,
"date_to": 1608660389,
"agent_id": 1001,
"support_id": 1002,
"video": true
},
"data": [ {
"id": 27233,
"start": 1608660273,
"stop": 1608660281,
"support_id": 1002,
"client": [ {
"user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/87.0.4280.88 Safari/537.36",
"login": "john.smith@gmail.com",
"geo": {
"ip": "94.242.23.99",
"country": "Russia",
"region": "St.-Petersburg",
"city": "St Petersburg"
}
} ],
"agent": {
"id": 1001,
"name": "DESKTOP-SJBU5PO",
"group": "Accounting",
"geo": {
"ip": "94.242.23.99",
"country": "Russia",
"region": "St.-Petersburg",
"city": "St Petersburg"
},
"os": "win",
"version": "2.1.5",
"owner": "john.smith@gmail.com"
},
"video": {
"url": "https://st.pro32connect.ru/video/2/27233.mp4",
"size": 428652
}
}, ... ]
}
| Имя | Тип | Описание |
|---|---|---|
id | number | Внутренний ID подключения в системе |
start | unixtime | Дата и время начала подключения |
stop | unixtime | Дата и время окончания подключения Может быть пустым, если подключение не завершено |
support_id | number | ID подключения по приглашению Поле может быть пустым, если подключение было к устройству с постоянным доступом |
client | array | Список клиентов, присоединившихся к подключению |
client[].user_agent | string | User agent |
client[].login | string | Логин клиента Может быть пустым, если подключение было анонимным |
client[].geo | object | Местоположение |
client[].geo.ip | string | IP-адрес |
client[].geo.country | string | Страна |
client[].geo.region | string | Регион |
client[].geo.city | string | Город |
agent | object | Информация об агенте |
agent.id | number | Внутренний ID агента в системе |
agent.name | string | Имя агента |
agent.group | string | Группа агента |
agent.geo | object | Местоположение |
agent.geo.ip | string | IP-адрес |
agent.geo.country | string | Страна |
agent.geo.region | string | Регион |
agent.geo.city | string | Город |
agent.os | string | Операционная система. Возможные значения: win, mac, linux или android |
agent.version | string | Версия ПО |
agent.owner | string | Логин учетной записи владельца устройства с постоянным доступом |
video | object | Информация о записи видео Может отсутствовать, если подключение не записывалось |
video.url | string | Адрес файла с записью видео Чтобы скачать файл с записью подключения, добавьте параметр ?apikey= с вашим API-ключом. |
video.size | number | Размер файла записи видео в байтах |
Получить информацию о подключении¶
Чтобы получить информацию о конкретном подключении, используйте метод history/info
Запрос:
| Параметр | Тип | Значение |
|---|---|---|
session_id | number | Поиск по ID сессии |
session_uid | string | Поиск по UID сессии |
Ответ:
Пример ответа
Данные ответа
{
"id": 10573011,
"uid": "17542170487lJDSVaYcCPB2urQWvod1dipT8VlSWj41414945",
"agent_id": 1405303,
"account_id": 7915,
"agent_account_id": 0,
"user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36",
"start": 1754217049,
"stop": 1754217227,
"video": "https://st.pro32connect.ru/video/1405303/10500000.mp4",
"video_size": 7530661,
"turbo_one_time": false,
"visor_comment": "",
"url": "/mn3-u1r-e7u",
"mode": "control",
"client": {
"ip": "94.242.23.99",
"country": "Russia",
"region": "St.-Petersburg",
"city": "St Petersburg"
},
"agent": {
"ip": "94.41.230.200",
"country": "Russia",
"region": "Bashkortostan Republic",
"city": "Sterlitamak"
}
}
| Название | Тип | Описание |
|---|---|---|
id | number | Внутрисистемный идентификатор подключения |
uid | string | Внутрисистемный идентификатор подключения |
agent_id | number | Внутрисистемный идентификатор агента |
account_id | number | Внутрисистемный идентификатор подключившегося техника |
agent_account_id | number | Внутрисистемный идентификатор к какой команде привязан агент |
start | unixtime | Дата и время начала подключения |
stop | unixtime | Дата и время конца подключения Может быть пустым, если подключение не завершено |
video | string | Адрес для загрузки видео-файла записи Чтобы загрузить видео-файл записи подключения необходимо добавить параметр ?apikey= со значением вашего API-ключа. |
video.size | number | Размер видео-файла записи в байтах |
turbo_one_time | boolean | Подключение к агенту по одноразовой ссылке |
visor_comment | string | Комментарий к сеансу подключения |
url | string | Ссылка агента |
mode | string | Тип подключения. Возможные значения:
|
client | object | Информация о подключившемся технике |
client.ip | string | IP-адрес |
client.country | string | Страна |
client.region | string | Регион |
client.city | string | Город |
agent | object | Информация об агенте |
agent.ip | string | IP-адрес |
agent.country | string | Страна |
agent.region | string | Регион |
agent.city | string | Город |