IAPI DION активно развивается, добавляются новые методы и функции.
Если вы не нашли нужный вам метод, сообщите об этом, мы постараемся помочь.
Взаимодействие с IAPI происходит по HTTPS-протоколу с использованием mTLS.
Аутентификация запросов в DION происходит по токену доступа. Выпустить токен доступа необходимо в административной панели DION. Токен имеет ограниченный срок действия, указанный при создании. В запросах к DION токен необходимо передать в заголовке X-Client-Access-Token. Количество токенов для организации не ограничено. Инструкция по созданию токена доступна здесь.
Максимальная рекомендуемая нагрузка указана в таблице:
| Метрика | Значение |
|---|---|
| Общее количество запросов | 100/ 60s |
| Количество единовременных запросов | 10/1s |
При работе с методами из данного раздела учтите следующие правила:
❗ Все e-mail адреса, которые вы передаете в запросе, должны быть зарегистрированы в DION (созданы учетные записи). Пользователи этих учетных записей должны хотя бы раз войти в DION.
❗ Владелец комнаты (owner_email) автоматически является и модератором. Не нужно передавать его e-mail в параметре “moderators_emails”.
Endpoint: POST api-integration.dion.vc/v1/events
Метод позволяет:
- Задать владельца конференции (в рамках его учетной записи будет создана комната)
- Выбрать, на каких серверах будет проходить медиа-трафик:
- Назначить модераторов
- Выбрать тип ссылки:
- Настроить параметры конференции:
- Настроить отображение конференции в личном кабинете
💡 Иногда релизы DION могут выходить чаще, чем обновления данного документа.
Все настройки, доступные для конференций, можно получить при помощи метода:
GET api-integration.dion.vc/v1/events/params
Параметры запроса:
| Название параметра | Вложенный параметр | Тип | Обязательность заполнения | Описание |
|---|---|---|---|---|
| event_params | array of strings | optional | Настройки комнаты при создании. Организатор может изменить их позже из личного кабинета DION. Вложенные параметры указываются как строки внутри массива. Разделитель — запятая. | |
| guest_access | string | optional | Если присутствует в запросе, вход для гостей открыт. В конференцию может подключиться любой пользователь, имеющий ссылку или номер телефона для подключения |
|
| waiting_room | string | optional | Если присутствует в запросе, комната создается с залом ожидания. Владелец события или модератор решают, впустить ли участника из зала ожидания в основную комнату конференции |
|
| access_only_with_moderators | string | optional | Если присутствует в запросе, вход в комнату доступен только в присутствии модератора или организатора. Без владельца или модератора событие не сможет начаться. После выхода всех модераторов из конференции событие завершится. |
|
| access_code_for_guests | string | optional | Если присутствует в запросе, при входе в конференцию гостям нужно будет ввести пин-код. | |
| access_code_for_all | string | optional | Если присутствует в запросе, при входе в конференцию пользователям нужно будет ввести пин-код | |
| disable_chat | string | optional | Если присутствует в запросе, чат будет недоступен в конференции. |
|
| webinar_mode | string | optional | Если присутствует в запросе, конференция создается в режиме вебинара. При включенном режиме все участники будут заходить в конференцию без доступа к микрофона и демонстрации экрана. Камера будет доступна. Внутри конференции доступы к микрофону и демонстрации экрана можно выдать участнику сделав его спикером. |
|
| breakout_rooms_mode | string | optional | Если присутствует в запросе, конференция создается в режиме сессионных залов. При включенном режиме пользователи смогут разделиться по рабочим группам во время конференции. |
|
| auto_record_two_users | string | optional | Если присутствует в запросе, в конференции будет включена автоматическая запись встречи при подключении второго пользователя. Запись завершается после выхода всех пользователей из конференции. Модераторы не могут включать/выключать запись встречи. | |
| phone_call_beeps | string | optional | Если присутсвует в запросе, в конференции инициатор звонка будет слышать гудки во время вызова на сотовый номер пользователя. | |
| is_on_cloud | boolean | mandatory |
Признак “Где будет проходить медиа-трафик конференции” для гибридного DION
Для полной On-Premise инсталляции
|
|
| link_settings | array of dict | mandatory | Параметры URL комнаты | |
| is_impersonal_slug | boolean | mandatory | Тип ссылки на комнату: с возможностью кастомизации и с привязкой к пользователю (например, https://dion.vc/ivanov-room-for-smth) или обезличенная (случайно созданная из 9 символов, например, https://dion.vc/aaa-bbb-ddd) | |
| slug | string | mandatory |
Окончание URL комнаты (пример: https://dion.vc/ivanov-room-for-smth). Для обезличенной комнаты значение не применяется, можно указать любое, так как поле все равно является обязательным |
|
| moderators_emails | array of strings | optional | Дополнительные модераторы конференции. Передаются e-mail-адреса УЗ пользователей в DION. Разделитель — запятая | |
| owner_email | string | mandatory | E-mail организатора: пользователя, под учетной записью которого необходимо создать комнату | |
| is_temporary | boolean | optional |
|
⚠️ Параметры в таблице выше передаются в виде JSON в теле POST запроса.
Схема запроса:
{
"event_params": [
"string",
"string"
],
"is_on_cloud": boolean,
"link_settings": {
"is_impersonal_slug": boolean,
"slug": "string"
},
"moderators_emails": [
"string",
"string"
],
"owner_email": "string",
"is_temporary": boolean
}
Параметры ответа:
| Название параметра | Вложенный параметр | Тип поля | Описание |
|---|---|---|---|
| id | string | Идентификатор комнаты в системе DION | |
| owner_email | string | E-mail адрес пользователя, под учетной записью которого создана комната | |
| moderators_emails | string | Дополнительные модераторы конференции. Передаются e-mail-адреса пользователей в DION. | |
| is_on_cloud | boolean |
Признак “Где будет проходить медиа-трафик конференции” ◦ true — конференция будет проходить на облачных серверах DION ◦ false — конференция будет проходить на серверах организации Для полной On-Premise инсталляции
|
|
| event_params | array of strings | Параметры создаваемой комнаты | |
| guest_access | string | если присутствует, вход для гостей открыт | |
| waiting_room | string | если присутствует, комната создана с залом ожидания | |
| access_only_with_moderators | string | если присутствует, вход в комнату доступен только в присутствии модератора или организатора | |
| access_code_for_guests | string | Если присутствует в запросе, при входе в конференцию гостям нужно будет ввести пин-код. | |
| access_code_for_all | string | Если присутствует в запросе, при входе в конференцию пользователям нужно будет ввести пин-код | |
| disable_chat | string | если присутствует, чат в конференции выключен | |
| webinar_mode | string | если присутствует, конференция создается в режиме вебинара | |
| phone_call_beeps | string | если присутствует, в конфернции включены гудки при вызовах на сотовые номера | |
| is_on_cloud | boolean |
Признак “Где будет проходить медиа-трафик конференции” для гибридного DION
Для полной On-Premise инсталляции
|
|
| is_temporary | boolean |
|
|
| link | string | URL комнаты | |
| link_settings | object | Параметры URL комнаты | |
| is_impersonal_slug | boolean | Тип ссылки на комнату: с возможностью кастомизации и с привязкой к пользователю или обезличенная | |
| slug | string | Окончание URL комнаты (пример: https://dion.vc/ivanov-room-for-smth) | |
| pstn | object | Массив данных для подключения к комнате с использованием телефонии | |
| number | string | Номер телефона для подключения к телефонии | |
| pin | int | Добавочный номер для подключения к комнате при помощи телефонии |
Схема ответа:
{
"id": "string",
"owner_email": "string",
"moderators_emails": [
"string",
"string"
],
"is_on_cloud": boolean,
"is_temporary": boolean,
"event_params": [
"string",
"string"
],
"link": "string",
"link_settings": {
"slug": "string"
},
"pstn": {
"number": "string",
"pin": int,
},
"is_temporary": boolean
}
Endpoint: GET api-integration.dion.vc/v1/events/event_id
Для получения данных по уже существующей конференции вашей организации, необходимо передать в URL запроса идентификатор комнаты.
Параметры запроса:
Path параметры:
| Название параметра | Тип поля | Обязательность заполнения | Описание |
|---|---|---|---|
| event_id | string | mandatory | Идентификатор комнаты |
Пример запроса:
GET api-integration.dion.vc/v1/events/bbb9bbbb-555b-bbb-b5bb-b2bb5bbbbb5b
Параметры ответа:
| Название параметра | Вложенный параметр | Тип поля | Описание |
|---|---|---|---|
| id | string | Идентификатор комнаты в системе DION | |
| owner_email | string | E-mail адрес пользователя, под учетной записью которого создана комната | |
| moderator_emails | string | Дополнительные модераторы конференции. Передаются e-mail-адреса пользователей в DION. | |
| is_on_cloud | boolean |
Признак “Где будет проходить медиа-трафик конференции” ◦ true — конференция будет проходить на облачных серверах DION ◦ false — конференция будет проходить на серверах организации Для полной On-Premise инсталляции
|
|
| is_temporary | boolean | ||
| event_params | array of strings | Параметры создаваемой комнаты | |
| guest_access | string | если присутствует, вход для гостей открыт | |
| waiting_room | string | если присутствует, комната создана с залом ожидания | |
| access_only_with_moderators | string | если присутствует, вход в комнату доступен только в присутствии модератора или организатора | |
| access_code_for_guests | string | Если присутствует в запросе, при входе в конференцию гостям нужно будет ввести пин-код. | |
| access_code_for_all | string | Если присутствует в запросе, при входе в конференцию пользователям нужно будет ввести пин-код | |
| disable_chat | string | если присутствует, чат в конференции выключен | |
| webinar_mode | string | если присутствует, конференция создается в режиме вебинара | |
| phone_call_beeps | string | если присутствует, в конфернции включены гудки при вызовах на сотовые номера | |
| link | string | URL комнаты | |
| link_settings | array of dict | Параметры URL комнаты | |
| slug | string | Окончание URL комнаты (пример: https://dion.vc/ivanov-room-for-smth) | |
| pstn | object | Массив данных для подключения к комнате с использованием телефонии | |
| number | string | Номер телефона для подключения к телефонии | |
| pin | int | Добавочный номер для подключения к комнате при помощи телефонии |
Схема ответа:
{
"id": "string",
"owner_email": "string",
"moderators_emails": [
"string",
"string"
],
"is_on_cloud": boolean,
"is_temporary": boolean ,
"event_params": [
"string",
"string"
],
"link": "string",
"link_settings": {
"is_impersonal_slug": boolean,
"slug": "string"
},
"pstn": {
"number": "string",
"pin": int,
}
}
Endpoint:
POST api-integration.dion.vc/v1/events/sessions
Для получения списка сесcий комнаты.
Входные параметры:
Body параметры
| Параметр | Описание | Тип | Обязательность | Пример | |
|---|---|---|---|---|---|
| time_start | Начало временного интервала | datetime UTC в соответствии RFC 3339 | Нет | ||
| time_end | Окончание временного интервала | datetime UTC в соответствии RFC 3339 | Нет | ||
| page | Номер страницы | number | Да | ||
| limit | Количество строк на странице | number | Да | ||
| event_ids | Массив событий не более 5000 элементов | array | Да | ||
| event_id | Идентификатор комнаты в формате уникального кода | string | Да | ||
Выходные параметры:
| Параметр | Описание | Тип | Обязательность | Пример | ||
|---|---|---|---|---|---|---|
| items | Массив | |||||
| event_id | Идентификатор комнаты в формате уникального кода | string | Да | |||
| sessions | Объект данных с информацией о сессии конференции | object | Да | |||
| id | Идентификатор сессии конференции | string | Да | |||
| session_start | Время создания сессии конференции | string | Да | |||
| session_end | Время окончания сессии конференции | string | Да | |||
| pagination | ||||||
| all_pages | Всего страниц | number | Да | 5 | ||
| all_records | Всего записей | number | Да | 150 | ||
| current_page | Текущая страница | number | Да | 1 | ||
| Особенности работы |
|
|---|---|
| Коды состояния HTTP |
|
Обработка ошибок
| HTTP status code | errorMessage | Описание |
|---|---|---|
| <Текст возвращаемого сообщения> | <В каких случаях возникает исключение> | |
Endpoint: PUT api-integration.dion.vc/v1/events/event_id
Метод позволяет изменить настройки уже созданной комнаты для вашей организации.
В URL запроса необходимо передать идентификатор комнаты. В теле — новые значения параметров.
Параметры запроса:
Body параметры:
| Название параметра | Вложенный параметр | Тип | Обязательность заполнения | Описание |
|---|---|---|---|---|
| event_params | array of strings | optional | Настройки комнаты при создании. Организатор может изменить их позже из личного кабинета DION. Вложенные параметры указываются как строки внутри массива. Разделитель — запятая. | |
| guest_access | string | optional | Если присутствует в запросе, вход для гостей открыт. В конференцию может подключиться любой пользователь, имеющий ссылку или номер телефона для подключения |
|
| waiting_room | string | optional | Если присутствует в запросе, комната создается с залом ожидания. Владелец события или модератор решают, впустить ли участника из зала ожидания в основную комнату конференции |
|
| access_only_with_moderators | string | optional | Если присутствует в запросе, вход в комнату доступен только в присутствии модератора или организатора. Без владельца или модератора событие не сможет начаться. После выхода всех модераторов из конференции событие завершится. |
|
| access_code_for_guests | string | optional | Если присутствует в запросе, при входе в конференцию гостям нужно будет ввести пин-код. | |
| access_code_for_all | string | optional | Если присутствует в запросе, при входе в конференцию пользователям нужно будет ввести пин-код | |
| disable_chat | string | optional | Если присутствует в запросе, чат будет недоступен в конференции. |
|
| webinar_mode | string | optional | Если присутствует в запросе, конференция создается в режиме вебинара. При включенном режиме все участники будут заходить в конференцию без доступа к микрофона и демонстрации экрана. Камера будет доступна. Внутри конференции доступы к микрофону и демонстрации экрана можно выдать участнику сделав его спикером. |
|
| breakout_rooms_mode | string | optional | Если присутствует в запросе, конференция создается в режиме сессионных залов. При включенном режиме пользователи смогут разделиться по рабочим группам во время конференции. |
|
| auto_record_two_users | string | optional | Если присутствует в запросе, в конференции будет включена автоматическая запись встречи при подключении второго пользователя. Запись завершается после выхода всех пользователей из конференции. Модераторы не могут включать/выключать запись встречи. | |
| phone_call_beeps | string | optional | Если присутсвует в запросе, в конференции инициатор звонка будет слышать гудки во время вызова на сотовый номер пользователя. | |
| is_on_cloud | boolean | optional |
Признак “Где будет проходить медиа-трафик конференции” для гибридного DION
Для полной On-Premise инсталляции
|
|
| link_settings | array of dict | optional | Параметры URL комнаты | |
| is_impersonal_slug | boolean | optional | Тип ссылки на комнату: с возможностью кастомизации и с привязкой к пользователю (например, https://dion.vc/ivanov-room-for-smth) или обезличенная (случайно созданная из 9 символов, например, https://dion.vc/aaa-bbb-ddd) | |
| slug | string | optional |
Окончание URL комнаты (пример: https://dion.vc/ivanov-room-for-smth). Для обезличенной комнаты значение не применяется, можно указать любое, так как поле все равно является обязательным |
|
| moderator_emails | array of strings | optional | Дополнительные модераторы конференции. Передаются e-mail-адреса УЗ пользователей в DION. Разделитель — запятая | |
| owner_email | string | mandatory | E-mail организатора: пользователя, под учетной записью которого необходимо создать комнату | |
| is_temporary | boolean | optional |
|
Схема параметров в теле запроса:
{
"event_params": [
"string",
"string"
],
"is_on_cloud": boolean,
"link_settings": {
"is_impersonal_slug": boolean,
"slug": "string"
},
"moderators_emails": [
"string",
"string"
],
"owner_email": "string",
"is_temporary": boolean
}
Параметры ответа:
| Название параметра | Вложенный параметр | Тип поля | Описание |
|---|---|---|---|
| id | string | Идентификатор комнаты в системе DION | |
| owner_email | string | E-mail адрес пользователя, под учетной записью которого создана комната | |
| moderator_emails | string | Дополнительные модераторы конференции. Передаются e-mail-адреса пользователей в DION. | |
| is_on_cloud | boolean |
Признак “Где будет проходить медиа-трафик конференции” ◦ true — конференция будет проходить на облачных серверах DION ◦ false — конференция будет проходить на серверах организации Для полной On-Premise инсталляции
|
|
| event_params | array of strings | Параметры создаваемой комнаты | |
| guest_access | string | если присутствует, вход для гостей открыт | |
| waiting_room | string | если присутствует, комната создана с залом ожидания | |
| access_only_with_moderators | string | если присутствует, вход в комнату доступен только в присутствии модератора или организатора | |
| access_code_for_guests | string | Если присутствует в запросе, при входе в конференцию гостям нужно будет ввести пин-код. | |
| access_code_for_all | string | Если присутствует в запросе, при входе в конференцию пользователям нужно будет ввести пин-код | |
| disable_chat | string | если присутствует, чат в конференции выключен | |
| webinar_mode | string | если присутствует, конференция создается в режиме вебинара | |
| phone_call_beeps | string | если присутствует, в конфернции включены гудки при вызовах на сотовые номера | |
| link | string | URL комнаты | |
| link_settings | array of dict | Параметры URL комнаты | |
| is_impersonal_slug | boolean | Тип ссылки на комнату: с возможностью кастомизации и с привязкой к пользователю или обезличенная | |
| slug | string | Окончание URL комнаты (пример: https://dion.vc/ivanov-room-for-smth) | |
| pstn | object | Массив данных для подключения к комнате с использованием телефонии | |
| number | string | Номер телефона для подключения к телефонии | |
| pin | int | Добавочный номер для подключения к комнате при помощи телефонии | |
| is_temporary | boolean | Отображение конфренции в личном кабинете организатора |
Схема параметров ответа:
{
"id": "string",
"owner_email": "string",
"moderators_emails": [
"string",
"string"
],
"is_on_cloud": boolean,
"is_temporary": boolean,
"event_params": [
"string",
"string"
],
"link": "string",
"link_settings": {
"slug": "string"
},
"pstn": {
"number": "string",
"pin": int,
}
}
Endpoint: DELETE api-integration.dion.vc/v1/events/event_id
Для удаления конференции необходимо передать идентификатор комнаты в URL запроса.
Параметры запроса:
Path параметры:
| Название параметра | Тип поля | Обязательность заполнения | Описание |
|---|---|---|---|
| event_id | string | mandatory | Идентификатор комнаты |
При успешной обработке запроса в ответе будет отправлен http-code 204.
Endpoint: GET api-integration.dion.vc/v1/events/get-slug-by-owner-email
Метод позволяет получить список адресов (slug) созданных и не удаленных пользователем комнат по его почте.
Для получения списка комнат необходимо передать в запросе параметры:
Параметры запроса:
Query параметры:
| Название параметра | Тип поля | Обязательность заполнения | Описание |
|---|---|---|---|
| string | mandatory | Почта пользователя | |
| page | string | optional | Номер страницы |
| limit | string | optional | Количество записей на странице |
Запрос без пагинации:
GET api-integration.dion.vc/v1/events/get-slug-by-owner-email?email=user@test.ru
Запрос с пагинацией:
GET api-integration.dion.vc/v1/events/get-slug-by-owner-email?email=user@test.ru&limit=10&page=2
Параметры ответа:
| Название параметра | Вложенный параметр | Тип поля | Описание |
|---|---|---|---|
| events_slug | array | Массив адресов комнат | |
| pagination | array | Массив пагинации | |
| all_pages | string | Количество страниц с результатами обработки запроса | |
| all_records | string | Количество записей результата обработки запроса | |
| current_page | string | Текущая страница |
Схема параметров ответа:
{
"events_slug": [
"string",
"string"
],
"pagination": {
"current_page": int,
"all_pages": int,
"all_records": int
}
}
Endpoint: POST api-integration.dion.vc/v1/invites
Метод позволяет создать индивидуальную ссылку на комнату с ограниченным временем действия для конкретного пользователя. По этой ссылке пользователь попадет в конференцию с заранее определенным на этапе создания ссылки именем в обход авторизации.
Параметры в данном методе должны передаваться в теле запроса в формате json.
Параметры запроса:
Body параметры:
| Название параметра | Тип поля | Обязательность заполнения | Описание |
|---|---|---|---|
| event_id | string | mandatory | Идентификатор конференции |
| valid_before | string | optional | datetime, до которого валиден инвайт (если не указано, то 24 часа) |
| name | string | mandatory | Имя пользователя, которое будет отображаться при подключении в комнату Dion по созданной ссылке |
| intermadiate_id | string | optional | Идентификатор пользователя в системе-потребителе. Если не передан в запросе, генерируется случайным образом |
Дата-время указывается в формате RFC3339 (пример: 2024-10-03T12:53:05Z)
Схема параметров запроса:
{
"event_id": "string",
"valid_before": "string",
"name":"string",
"intermadiate_id":"string"
}
Параметры ответа:
| Название параметра | Вложенные параметры | Тип поля | Описание |
|---|---|---|---|
| user | dictionary | Массив пользователя | |
| id | string | Идентификатор пользователя | |
| name | string | Имя пользователя инвайта, которое будет отображаться при подключении в комнату Dion | |
| intermediate_id | string | Идентификатор пользователя в системе-потребителе. Если не передан в запросе, не вернется в ответе | |
| link | string | URL инвайта | |
| invite_link_hash | string | hash link инвайта | |
| valid_before | string | datetime, до которого валиден инвайт |
Схема параметров ответа:
{
"user":{
"id": "string",
"name":"string",
"intermediate_id": "string"
},
"link": "string",
"invite_link_hash":"string",
"valid_before": "string"
}
Endpoint: GET api-integration.dion.vc/v1/invites/hash
Метод позволяет получить информацию о ранее созданном инвайте. Для получения данных необходимо передать hash link этого инвайта в URL запроса.
Параметры запроса:
Path параметры:
| Название параметра | Тип поля | Обязательность заполнения | Описание |
|---|---|---|---|
| hash | string | mandatory | hash link инвайта |
Параметры ответа:
| Название параметра |
Вложенные параметры 1 уровня |
Вложенные параметры 2 уровня |
Тип поля | Описание |
|---|---|---|---|---|
| invite_link | dictionary | Массив данных об инвайте | ||
| user | dictionary | Массив пользователя | ||
| id | string | Идентификатор пользователя | ||
| name | string | Имя пользователя инвайта, которое будет отображаться при подключении в комнату Dion | ||
| intermediate_id | string | Идентификатор пользователя в системе-потребителе. Если не передан в запросе, сгенерируется случайным образом. Может отсутствовать в ответе. | ||
| link | string | URL инвайта | ||
| invite_link_hash | string | hash link инвайта | ||
| valid_before | string | datetime, до которого валиден инвайт | ||
| event | dictionary | Массив конференции | ||
| id | string | Идентификатор комнаты в системе DION | ||
| slug | string | Окончание URL комнаты (пример: https://dion.vc/ivanov-room-for-smth) |
Схема параметров ответа:
{
"invite_link": {
"user": {
"id": "string",
"name": "string",
"intermediate_id": "string"
},
"link": "string",
"invite_link_hash": "string",
"valid_before": "string",
},
"event": {
"id": "string",
"slug": "string"
}
}
Endpoint: DELETE api-integration.dion.vc/v1/invites/hash
Метод позволяет удалить ранее созданный инвайт. Для удаления необходимо передать hash этого инвайта в URL запроса.
Параметры запроса:
Path параметры:
| Название параметра | Тип поля | Обязательность заполнения | Описание |
|---|---|---|---|
| hash | string | mandatory | hash link инвайта |
При успешной обработке запроса в ответе будет отправлен http-code 204.
Формат ответа, если инвайт не существует:
{
"code": 404,
"message": "получение инвайта: rpc error: code = NotFound desc = invite not found: unknown entity"
}
Endpoint: GET api-integration.dion.vc/v1/events/:event_id/phone-calls-report
Метод позволяет получить информацию о вызовах из конференции на номера телефонов.
Параметры запроса:
Path параметры:
| Название параметра | Тип поля | Обязательность заполнения | Описание |
|---|---|---|---|
| event_id | uuid | mandatory | Идентификатор конференции |
Query параметры:
| Название параметра | Тип поля | Обязательность заполнения | Описание |
|---|---|---|---|
| time_start | datetime | optional | Время начала рассматриваемого периода |
| time_end | datetime | optional | Время окончания рассматриваемого периода |
| page | string | optional | Номер страницы |
| limit | string | optional | Количество записей на странице |
Дата-время указывается в формате RFC3339.
Параметры ответа:
| Название параметра | Вложенный параметр | Тип поля | Описание |
|---|---|---|---|
| pagination | array of dict | Массив пагинации | |
| current_page | string | Текущая страница | |
| all_pages | string | Количество страниц с результатами обработки запроса | |
| all_records | string | Количество записей результата обработки запроса | |
| event_id | string | Идентификатор конференции | |
| owner_id | string | Идентификатор пользователя, под учетной записью которого создана комната | |
| calls | object | Информация по звонкам из конференции | |
| session_id | string | Идентификатор сессии звонка | |
| initiator_user_id | string | Идентификатор инициатора вызова | |
| phone | string | Номер телефона, на который осуществлен вызов | |
| session_status | string | Массив статусов звонка | |
| status | string | Статус вызова, который передает оператор | |
| time | string | Время получения статуса |
Схема параметров ответа:
{
"pagination": {
"current_page":int,
"all_pages": int,
"all_records": int
},
"event_id" :"string",
"owner_id": "string",
"calls": [
{
"session_id": "string",
"initiator_user_id": "string",
"phone": "string",
"session_status": [
{
"status": "string",
"time":"string"
}
]
}
]
}
При работе с методами этого раздела учтите следующие правила:
❗ Параметры даты и времени передаются в формате RFC3339. На каждом параметре нужно делать urlencode.
Endpoint:
GET api-integration.dion.vc/v1/user
Для запроса данных учетной записи пользователя необходимо в query параметры передать email, который использовался при регистрации.
Параметры запроса:
Query параметры:
| Название параметра | Тип поля | Обязательность заполнения | Описание |
|---|---|---|---|
| string | mandatory | email пользователя |
Параметры ответа:
| Название параметра | Тип поля | Описание |
|---|---|---|
| id | string | Идентификатор учетной записи пользователя |
| string | email пользователя | |
| created_at | string | Дата создания учетной записи |
Схема параметров ответа:
{
"id": "844f90a5-ecd7-4259-80b2-86eabf1a62f8",
"email": "user-mail@test.ru",
"created_at": "2006-01-02T15:04:05Z"
}
Endpoint:
GET api-integration.dion.vc/v1/user/user_id
Параметры запроса:
Path параметры:
| Название параметра | Тип поля | Обязательность заполнения | Описание |
|---|---|---|---|
| user_id | string | Да | Идентификатор пользователя |
Параметры ответа:
| Название параметра | Тип поля | Описание |
|---|---|---|
| id | string | Идентификатор пользователя |
| string | Почта пользователя | |
| avatar_http_path | string | Ссылка на аватар |
| status | string | Статус пользователя |
| initials | string | Инициалы пользователя |
| name | string | Полное имя пользователя |
| position | string | Должность пользователя |
| created_at | string | Дата создания учетной записи пользователя |
| deleted_at | string | Дата удаления учетной записи пользователя |
Endpoint:
GET api-integration.dion.vc/v1/users
Параметры запроса:
Query параметры:
| Название параметра | Тип поля | Обязательность заполнения | Описание |
|---|---|---|---|
| page | string | Нет | Номер страницы |
| limit | string | Нет | Количество записей на странице |
| created_at_from | string | Нет | Фильтр “Дата создания УЗ с” |
| created_at_to | string | Нет | Фильтр “Дата создания УЗ по” |
Параметры ответа:
| Название параметра | Тип поля | Описание | |
|---|---|---|---|
| pagination | dictionary | Массив пагинации | |
| current_page | string | Текущая страница | |
| all_pages | string | Количество страниц с результатами обработки запроса | |
| all_records | string | Количество записей результата обработки запроса | |
| users | array of dictionaries | Массив пользователей | |
| id | string | Идентификатор пользователя | |
| string | Почта пользователя | ||
| status | string |
Статус пользователя. Возможные значения:
|
|
| avatar_http_path | string | Ссылка на автар | |
| initials | string | Инициалы пользователя | |
| name | string | Полное имя пользователя | |
| position | string | Должность пользователя | |
| created_at | string | Дата создания учетной записи пользователя | |
| deleted_at | string | Дата удаления учетной записи пользователя | |
Важные условия и ограничения:
Максимальный лимит кол-ва записей на странице в методах = 100
Схема параметров ответа:
{
"pagination": {
"all_pages": 5,
"all_records": 500,
"current_page": 1
},
"users": [
{
"id": "844f90a5-ecd7-4259-80b2-86eabf1a62f8",
"email": "user-mail@test.ru",
"created_at": "2006-01-02T15:04:05Z",
"status": "active"
}
]
}
Endpoint:
GET api-integration.dion.vc/v1/users/search
Параметры запроса:
Query параметры:
| Название параметра | Тип поля | Обязательность заполнения | Описание |
|---|---|---|---|
| string | Да | Электронная почта | |
| page | string | Нет | Номер страницы |
| limit | string | Нет | Количество записей на странице |
Параметры ответа:
| Название параметра | Тип поля | Описание | |
|---|---|---|---|
| pagination | dictionary | Массив пагинации | |
| current_page | string | Текущая страница | |
| all_pages | string | Количество страниц с результатами обработки запроса | |
| all_records | string | Количество записей результата обработки запроса | |
| users | array of dictionaries | Массив пользователей | |
| id | string | Идентификатор пользователя | |
| string | Почта пользователя | ||
| avatar_http_path | string | Ссылка на автар | |
| status | string | Статус пользователя | |
| initials | string | Инициалы пользователя | |
| name | string | Полное имя пользователя | |
| position | string | Должность пользователя | |
| created_at | string | Дата создания учетной записи пользователя | |
| deleted_at | string | Дата удаления учетной записи пользователя | |
Для получения данных используются таблицы api_clients.users
Важные условия и ограничения:
Максимальный лимит кол-ва записей на странице в методах = 100
Метод получения списка пользователей должен позволять осуществлять поиск по всем полям в query-параметрах, причем поиск должен отрабатывать как по полному вхождению слова, так и по первым введенным символам (первым 2 символам) и возвращать список всех возможных значений.
Параметры поиска:
Endpoint:
DELETE api-integration.dion.vc/v1/users/{user_id}
Для удаления пользователя необходимо передать идентификатор его учетной записи в URL запроса.
Параметры запроса:
Path параметры:
| Название параметра | Тип поля | Обязательность заполнения | Описание |
|---|---|---|---|
| user_id | string | Да | Идентификатор учетной записи пользователя |
При успешной обработке запроса в ответе будет отправлен http-code 204.
Ответ, в случае, если пользователь не найден:
{
"code": 404,
"message": "Объект не найден"
}
Endpoint:
PUT /v1/users/{user_id}/block
Для блокировки пользователя необходимо передать id пользователя.
Параметры запроса:
Path параметры:
| Название параметра | Тип поля | Обязательность заполнения | Описание |
|---|---|---|---|
| user_id | string | mandatory | Идентификатор учетной записи пользователя |
При успешной обработке запроса в ответе будет отправлен http-code 204.
Возможные ошибки в ответе:
|
|
Endpoint:
PUT /v1/users/{user_id}/unblock
Для разблокировки пользователя необходимо передать id пользователя.
Параметры запроса:
Path параметры:
| Название параметра | Тип поля | Обязательность заполнения | Описание |
|---|---|---|---|
| user_id | string | Да | Идентификатор учетной записи пользователя |
При успешной обработке запроса в ответе будет отправлен http-code 204.
Возможные ошибки в ответе:
|
|
Endpoint:
GET api-integration.dion.vc/v1/events/{event_id}/users
Получение списка пользователей в конференции за заданный промежуток времени (Доступны интервалы до 5 часов)
Пример запроса с фильтрацией по дате:
GET api-integration.dion.vc/v1/events/eventid/users?page=1&limit=100&time_start=2022-01-01T03:00:00Z&time_end=2022-01-31T21:00:00Z
Параметры запроса:
Path параметры:
| Название параметра | Тип поля | Обязательность заполнения | Описание |
|---|---|---|---|
| event_id | uuid | Да | Идентификатор конференции |
Query параметры:
| Название параметра | Тип поля | Обязательность заполнения | Описание |
|---|---|---|---|
| time_start | datetime | Да | Время начала рассматриваемого периода |
| time_end | datetime | Да | Время окончания рассматриваемого периода |
| page | string | Да | Номер страницы |
| limit | string | Да | Количество записей на странице |
Параметры ответа:
| Название параметра | Вложенные параметры | Тип поля | Описание |
|---|---|---|---|
| pagination | dictionary | Массив пагинации | |
| current_page | string | Текущая страница | |
| all_pages | string | Количество страниц с результатами обработки запроса | |
| all_records | string | Количество записей результата обработки запроса | |
| users | array of dictionaries | Массив пользователей | |
| user_id | string | Идентификатор пользователя | |
| name | string | Имя пользователя, указанное в Dion | |
| position | string | Должность, указанная в Dion | |
| sessions | array of strings | Массив пользовательских сессий | |
| id | string | Идентификатор пользовательской сессии | |
| session_start | string | Время создания сессии пользователя | |
| session_end | string | Время окончания сессии пользователя |
Схема параметров ответа:
{
"pagination":{
"current_page":1,
"all_pages":1,
"all_records":13
},
"users":[
{
"user_id":"string",
"name":"string",
"position":"string",
"email":"string",
"sessions":[
{
"id":"string",
"session_start":"datetime",
"session_end":"datetime"
}
]
}
]
}
Получение списка сессий в конференции за заданный промежуток времени
Endpoint:
GET api-integration.dion.vc/v1/events/event_id/sessions
Параметры запроса:
Path параметры:
| Название параметра | Тип поля | Обязательность заполнения | Описание |
|---|---|---|---|
| event_id | uuid | mandatory | Идентификатор конференции |
Query параметры:
| Название параметра | Тип поля | Обязательность заполнения | Описание |
|---|---|---|---|
| time_start | datetime | optional | Время начала рассматриваемого периода |
| time_end | datetime | optional | Время окончания рассматриваемого периода |
| page | string | mandatory | Номер страницы |
| limit | string | mandatory | Количество записей на странице |
Параметры ответа:
| Название параметра | Вложенные параметры | Тип поля | Описание |
|---|---|---|---|
| pagination | dictionary | Массив пагинации | |
| current_page | string | Текущая страница | |
| all_pages | string | Количество страниц с результатами обработки запроса | |
| all_records | string | Количество записей результата обработки запроса | |
| sessions | object | Объект данных с информацией о сессии конференции | |
| id | string | Идентификатор сессии конференции | |
| session_start | string | Время создания сессии конференции | |
| session_end | string | Время окончания сессии конференции |
Схема параметров ответа:
{
"pagination":{
"current_page":1,
"all_pages":1,
"all_records":13
},
"sessions":[
{
"id":"”string”",
"session_start":"datatime",
"session_end":"datetime"
}
]
}
Метод позволяет отобразить в списке участников заранее выбранный номер телефона ("приглашенный номер"), на который можно позвонить из конференции без ввода номера вручную.
Список приглашенных номеров увидят только модераторы конференции.
Для создания приглашенного номера в существующей конференции вашей организации, необходимо передать в URL запроса идентификатор комнаты.
Endpoint:
POST api-integration.dion.vc/v1/events/{event_id}/predefined-phone-numbers
Параметры запроса:
Path параметры:
| Название параметра | Тип поля | Обязательность заполнения | Описание |
|---|---|---|---|
| event_id | string | mandatory | Идентификатор комнаты |
Body параметры:
| Название параметра | Вложенные параметры | Тип поля | Обязательность заполнения | Возможные значения | Описание |
|---|---|---|---|---|---|
| predefined_phone_numbers | array of strings | mandatory | Массив номеров | ||
| phone_number | string | mandatory | +79991234567 | Приглашенный номер телефона для конференции |
Максимальный лимит приглашенных номеров в 1 конференции = 100.
Номера телефона необходимо передавать в формате: код страны «+7» и номер телефона из 10 цифр (слитно, без разделителей и спецсимволов).
Схема параметров запроса:
{
"predefined_phone_numbers":
[
{
"phone_number":"+74950000000"
}
]
}
Параметры ответа:
| Название параметра | Вложенные параметры | Тип поля | Описание |
|---|---|---|---|
| event_id | string | Идентификатор комнаты в системе DION | |
| predefined_phone_numbers | array of dictionaries | Массив номеров | |
| id | string | Идентификатор приглашенного номера в комнате | |
| phone_number | string | Приглашенный номер телефона для комнаты |
Схема параметров ответа:
{
"event_id": "string",
"predefined_phone_numbers": [
{
"id": "string",
"phone_number": "string"
}
]
}
Метод позволяет получить список приглашенных номеров телефона для конференции. .
Для получения списка, необходимо передать в URL запроса идентификатор комнаты.
Endpoint:
GET api-integration.dion.vc/v1/events/event_id/predefined-phone-numbers
Параметры запроса:
Path параметры:
| Название параметра | Тип поля | Обязательность заполнения | Описание |
|---|---|---|---|
| event_id | string | mandatory | Идентификатор комнаты |
Параметры ответа:
| Название параметра | Вложенные параметры | Тип поля | Описание |
|---|---|---|---|
| event_id | string | Идентификатор комнаты в системе DION | |
| predefined_phone_numbers | array of dictionaries | Массив номеров | |
| id | string | Идентификатор приглашенного номера в комнате | |
| phone_number | string | Приглашенный номер телефона для комнаты |
Схема параметров ответа:
{
"event_id": "string",
"predefined_phone_numbers": [
{
"id": "string",
"phone_number": "string"
}
]
}
Метод позволяет удалить все приглашенные номера телефона из конференции.
Для удаления списка приглашенных номеров в существующей конференции вашей организации, необходимо передать в URL запроса идентификатор комнаты.
Endpoint:
DELETE api-integration.dion.vc/v1/events/event_id/predefined-phone-numbers
Параметры запроса:
Path параметры:
| Название параметра | Тип поля | Обязательность заполнения | Описание |
|---|---|---|---|
| event_id | string | mandatory | Идентификатор комнаты |
При успешной обработке запроса в ответе будет отправлен http-code 204.
Ответ, в случае, если номеров не существует:
{
"code": 404,
"message": "удаление номеров телефонов: rpc error: code = NotFound desc = predefined phones not found: unknown entity"
}
Endpoint:
GET api-integration.dion.vc/v1/users-groups
Список возвращаемых кодов с кратким описанием:
Входные параметры:
Query параметры
| Параметр | Описание | Тип | Обязательность | Пример |
|---|---|---|---|---|
| group_codes | Типы групп для поиска | []string | НЕТ | conference_separate_phone_number |
| limit |
Максимальное количество записей, которое возвращается Если значение не передано, то возвращается 50 записей |
int | НЕТ | 10 |
| page |
Страница списка, которую необходимо получить Если значение не передано, то возвращается 1 страница |
int | НЕТ | 1 |
| search | Строка поиска. Допускается 1-3 слова, разделенные пробелами. Поиск ведется по полям name и description |
string | НЕТ | Тест |
Выходные параметры:
| Параметр | Описание | Тип | Обязательность | Маскирование | Пример | |
|---|---|---|---|---|---|---|
| items | ||||||
| id | Идентификатор группы пользователей | uuid | ДА | НЕТ | ||
| description | Описание группы пользователей | string | НЕТ | НЕТ | Тестовое описание | |
| group_code | Тип группы пользователей | string | ДА | НЕТ | conference_separate_phone_number | |
| name | Название группы пользователей | string | ДА | НЕТ | Тестовое название | |
| org_id | Демонстрация. RTT. Исходящий | uuid | ДА | НЕТ | d322da20-dfd1-4fa9-9beb-6d302a27c5f7 | |
| org_name | Название организации | string | ДА | НЕТ | Название организации | |
| users_count | Количество пользователей в группе | ДА | НЕТ | 100 | ||
| pagination | ||||||
| all_pages | Количество страниц | int | ДА | НЕТ | 20 | |
| all_records | Количество записей | int | ДА | НЕТ | 100 | |
| current_page | Текущая страница | int | ДА | НЕТ | 2 | |
Схема ответа:
{
"items": [
{
"description": "string",
"group_code": "string",
"id": "string",
"name": "string",
"org_id": "string",
"org_name": "string",
"users_count": 0
}
],
"pagination": {
"all_pages": 5,
"all_records": 500,
"current_page": 1
}
}
Endpoint:
GET api-integration.dion.vc/v1/users-groups/types
Список возвращаемых кодов с кратким описанием
Выходные параметры:
| Параметр | Описание | Тип | Обязательность | Маскирование | Пример | |
|---|---|---|---|---|---|---|
| items | ||||||
| id | Идентификатор типа группы пользователей | string | Да | НЕТ | video_allow_view_records | |
| name | Название типа группы пользователей | string | Да | НЕТ | Права на просмотр видео | |
| description | Описание типа группы пользователей | string | Да | НЕТ | Настройка дает возможность просматривать видео определенной группы владельцев | |
| hint | Подсказка для типа группы пользователей | uuid | Нет | НЕТ | ||
| warning_text | Предупреждение для типа группы пользователей | string | Нет | НЕТ | Вам необходимо будет назначить хотя бы одного администратора из числа участников группы в таблице Участники. Максимальное количество администраторов не ограничено | |
| member_role_codes | Роли пользователей в группе для типа группы пользователей | []string | Нет | НЕТ | ["group_admin","group_user"] | |
Схема ответа:
|
Endpoint:
POST api-integration.dion.vc/v1/users-groups
Список возвращаемых кодов с кратким описанием:
Входные параметры:
Body параметры:
| Параметр | Описание | Тип | Обязательность | Пример |
|---|---|---|---|---|
| group_code | Тип группы пользователей | string | ДА | conference_separate_phone_number |
| name | Название группы пользователей | string | ДА | Тестовое название |
| description | Описание группы пользователей | string | НЕТ | Тестовое описание |
Схема запроса:
|
Выходные параметры:
| Параметр | Описание | Тип | Обязательность | Маскирование | Пример |
|---|---|---|---|---|---|
| id | Идентификатор группы пользователей | uuid | ДА | НЕТ | |
| description | Описание группы пользователей | string | НЕТ | НЕТ | Тестовое описание |
| group_code | Тип группы пользователей | string | ДА | НЕТ | conference_separate_phone_number |
| name | Название группы пользователей | string | ДА | НЕТ | Тестовое название |
| org_id | Идентификатор организации | uuid | ДА | НЕТ | d322da20-dfd1-4fa9-9beb-6d302a27c5f7 |
| org_name | Название организации | string | ДА | НЕТ | Название организации |
| users_count | Количество пользователей в группе | int | ДА | НЕТ | 0 |
Схема ответа:
|
Endpoint:
GET api-integration.dion.vc/v1/users-groups/{group_id}
Список возвращаемых кодов с кратким описанием
Входные параметры:
Path параметры:
| Параметр | Описание | Тип | Обязательность | Пример |
|---|---|---|---|---|
| group_id | Идентификатор группы, по которой необходимо получить данные | uuid | ДА | d322da20-dfd1-4fa9-9beb-6d302a27c5f7 |
Пример запроса:
|
Выходные параметры:
| Параметр | Описание | Тип | Обязательность | Маскирование | Пример |
|---|---|---|---|---|---|
| id | Идентификатор группы пользователей | uuid | ДА | НЕТ | |
| description | Описание группы пользователей | string | НЕТ | НЕТ | Тестовое описание |
| group_code | Тип группы пользователей | string | ДА | НЕТ | conference_separate_phone_number |
| name | Название группы пользователей | string | ДА | НЕТ | Тестовое название |
| org_id | Демонстрация. RTT. Исходящий | uuid | ДА | НЕТ | d322da20-dfd1-4fa9-9beb-6d302a27c5f7 |
| org_name | Название организации | string | ДА | НЕТ | Название организации |
| users_count | Количество пользователей в группе | ДА | НЕТ | 100 |
Схема ответа:
|
Endpoint:
DELETE api-integration.dion.vc/v1/users-groups/{group_id}
Список возвращаемых кодов с кратким описанием
Входные параметры:
Path-параметры:
| Параметр | Описание | Тип | Обязательность | Пример |
|---|---|---|---|---|
| group_id | Идентификатор организации, по которой необходимо получить список групп | uuid | ДА | d322da20-dfd1-4fa9-9beb-6d302a27c5f7 |
Пример запроса:
api-integration.dion.vc/v1/users-groups/d322da20-dfd1-4fa9-9beb-6d302a27c5f7 |
Endpoint:
DELETE api-integration.dion.vc/v1/users-groups/{group_id}/members/{user_id}
Список возвращаемых кодов с кратким описанием
Входные параметры:
Path-параметры:
| Параметр | Описание | Тип | Обязательность | Пример |
|---|---|---|---|---|
| group_id | Идентификатор группы, внутри которой необходимо удалить участника | uuid | ДА | d322da20-dfd1-4fa9-9beb-6d302a27c5f7 |
| user_id | Идентификатор пользователя, которого необходимо удалить из группы | uuid | ДА | d322da20-dfd1-4fa9-9beb-6d302a27c5f8 |
Пример запроса:
api-integration.dion.vc/v1/users-groups/d322da20-dfd1-4fa9-9beb-6d302a27c5f7/members/d322da20-dfd1-4fa9-9beb-6d302a27c5f8 |
Endpoint:
GET api-integration.dion.vc/v1/users-groups/{group_id}/members
Список возвращаемых кодов с кратким описанием
Входные параметры:
Path параметры:
| Параметр | Описание | Тип | Обязательность | Пример |
|---|---|---|---|---|
| group_id | Идентификатор группы по которой запрашивается список участников | uuid | ДА | d322da20-dfd1-4fa9-9beb-6d302a27c5f7 |
Query параметры:
| Параметр | Описание | Тип | Обязательность | Пример |
|---|---|---|---|---|
| member_role_code | Идентификатор роли пользователей по которой запрашивается список участников | string | НЕТ | group_user |
| limit |
Максимальное количество записей которое возвращается Если значение не передано, то возвращается 50 записей |
int | НЕТ | 10 |
| page |
Страница списка которую необходимо получить Если значение не передано, то возвращается 1 страница |
int | НЕТ | 1 |
Пример запроса:
api-integration.dion.vc/v1/users-groups/d322da20-dfd1-4fa9-9beb-6d302a27c5f7/members?member_role_code=group_user |
Выходные параметры:
| Параметр | Описание | Тип | Обязательность | Маскирование | Пример | |
|---|---|---|---|---|---|---|
| items | ||||||
| group_id | Идентификатор группы пользователей | uuid | ДА | НЕТ | d322da20-dfd1-4fa9-9beb-6d302a27c5f7 | |
| user_id | идентификатор пользователя | uuid | ДА | НЕТ | d322da20-dfd1-4fa9-9beb-6d302a27c5f8 | |
| member_role_code | идентификатор роли пользователя | string | ДА | НЕТ | user_group | |
| name | Имя пользователя | string | ДА | НЕТ | Иванов Иван | |
| e-mail пользователя | string | ДА | НЕТ | test@test.ru | ||
| actions |
возможные действия которые можно выполнить с пользователей:
|
string | ДА | НЕТ | delete,set_admin |
|
| Pagination | ||||||
| all_pages | Количество страниц | int | ДА | НЕТ | 20 | |
| all_records | Количество записей | int | ДА | НЕТ | 100 | |
| current_page | Текущая страница | int | ДА | НЕТ | 2 | |
Схема ответа:
|
Endpoint:
GET api-integration.dion.vc/v1/users-groups/members/roles
Выходные параметры:
| Параметр | Описание | Тип | Обязательность | Маскирование | Пример | |
|---|---|---|---|---|---|---|
| items | ||||||
| id | Идентификатор роли пользователя | string | Да | НЕТ | group_admin | |
| name | Название роли пользователя | string | Да | НЕТ | Администратор группы | |
Схема ответа:
|
Endpoint:
POST api-integration.dion.vc/v1/users-groups/{group_id}/members
Список возвращаемых кодов с кратким описанием
Входные параметры:
Path параметры:
| Параметр | Описание | Тип | Обязательность | Пример |
|---|---|---|---|---|
| group_id | Идентификатор организации, в рамках которой необходимо создать группу пользователей | uuid | ДА | d322da20-dfd1-4fa9-9beb-6d302a27c5f7 |
Body параметр:
| Параметр | Описание | Тип | Обязательность | Пример |
|---|---|---|---|---|
| member_role_code | Роль пользователя | string | ДА | group_user |
| user_ids | Идентификаторы добавляемых пользователей | []string | ДА | [ "d322da20-dfd1-4fa9-9beb-6d302a27c5f8", "d322da20-dfd1-4fa9-9beb-6d302a27c5f9" ] |
Схема запроса:
|
Выходные параметры: отсутствуют
Endpoint:
PUT api-integration.dion.vc/v1/users-groups/{group_id}
Список возвращаемых кодов с кратким описанием
Входные параметры:
Path-параметры
| Параметр | Описание | Тип | Обязательность | Пример |
|---|---|---|---|---|
| group_id | Идентификатор группы, по которой необходимо получить список групп | uuid | ДА | d322da20-dfd1-4fa9-9beb-6d302a27c5f7 |
Body-параметр
| Параметр | Описание | Тип | Обязательность | Пример |
|---|---|---|---|---|
| group_code | Тип группы пользователей | string | ДА | conference_separate_phone_number |
| name | Название группы пользователей | string | ДА | Тестовое название |
| description | Описание группы пользователей | string | НЕТ | Тестовое описание |
Схема запроса:
|
Выходные параметры: отсутствуют
Endpoint:
PUT api-integration.dion.vc/v1/users-groups/{group_id}/members/{user_id}
Список возвращаемых кодов с кратким описанием
Входные параметры:
Path-параметры
| Параметр | Описание | Тип | Обязательность | Пример |
|---|---|---|---|---|
| group_id | Идентификатор организации, в рамках которой необходимо создать группу пользователей | uuid | ДА | d322da20-dfd1-4fa9-9beb-6d302a27c5f7 |
| user_id | Название группы пользователей | string | ДА | d322da20-dfd1-4fa9-9beb-6d302a27c5f8 |
Body-параметр
| Параметр | Описание | Тип | Обязательность | Пример |
|---|---|---|---|---|
| member_role_code | Описание группы пользователей | string | ДА | group_user |
Схема запроса:
|
Выходные параметры: отсутствуют
Endpoint:
GET api-integration.dion.vc/v1/videos
Метод возвращает все ссылки на записи видео и аудио по event_id
Параметры запроса:
Query параметры:
| Название параметра | Тип поля | Обязательность заполнения | Описание |
|---|---|---|---|
| event_id | string | mandatory | Идентификатор комнаты |
| page | string | optional | Номер страницы |
| limit | string | optional | Количество записей на странице |
| time_start | datetime | optional | Начало временного интервала |
| time_end | datetime | optional | Окончание вренеменного интервала |
Дата-время указывается в формате RFC3339 (пример: 2024-10-03T12:53:05Z)
Параметры ответа:
| Название параметра | Вложенный параметр | Тип поля | Описание |
|---|---|---|---|
| pagination | array | ||
| current_page | string | Текущая страница | |
| all_pages | Количество страниц с результатами обработки запроса | ||
| all_records | Количество записей результата обработки запроса | ||
| video_links | array of strings | Ссылки на записи в Дион.Видео |
Схема параметров ответа:
{
"pagination": {
"current_page": 1,
"all_pages": 1,
"all_records": 2
},
"video_links": [
"https://https://video.dion.vc/video/bda3573р-0081-4cbc-111a-753fe3a36af0",
"https://https://video.dion.vc/video/0f921310-68p5-44dc-8870-4f2ef03ea2eb"
]
}
API позволяет получать список событий аудита организации, это дает возможность организовать мониторинг и интеграцию с SIEM-системами.
Endpoint:
GET api-integration.dion.vc/v1/audits
Список возвращаемых кодов с кратким описанием
Входные параметры (Query):
| Параметр | Описание | Тип | Обязательность | Пример |
|---|---|---|---|---|
| limit | Количество строк для возврата. Максимальное значение - 500 | Int | Да | |
| last_audit_id | Идентификатор события аудита, после которого необходимо вернуть все имеющиеся события аудита | String | Нет |
Выходные параметры:
| Параметр | Описание | Тип | Пример | |
|---|---|---|---|---|
| audit_messages | Массив событий аудита | [] | ||
| id | Идентификатор события аудита | uuid | ||
| record_id | Идентификатор события аудита в формате int64 | int64 | ||
| user_id | Идентификатор пользователя | uuid | ||
| user_name | ФИО пользователя | String | ||
| user_email | Email пользователя | String | ||
| user_role | Роль пользователя | []String | ||
| event_id | Идентификатор события | uuid | ||
| event_slug | Slug события | String | ||
| message_type | Тип события аудита | String | ||
| created_at | Дата создания | Timestamp | ||
| platform | Название платформы пользователя | String | ||
| level | Уровень события | String | ||
| ip | IP адрес пользователя | String | ||
| user-agent | User agent пользователя | String | ||
| payload | Дополнительная информация | String | ||
Схема ответа:
{
"audit_messages": [
{
"id": "string",
"record_id": 0,
"user_id": "string",
"user_name": "string",
"user_email": "string",
"user_role": ["string"], "event_id": "string",
"event_slug": "string",
"message_type": "string",
"created_at": "string",
"platform": "string",
"level": "string",
"ip": "string",
"user-agent": "string",
"payload": "string"
}
]
}
Endpoint:
GET api-integration.dion.vc/v1/audits/types
Список возвращаемых кодов с кратким описанием
Входные параметры: отсутствуют
Выходные параметры:
| Параметр | Описание | Тип | Обязательность | Маскирование | Пример | |
|---|---|---|---|---|---|---|
| items | Массив типов событий аудита | [] | ||||
| name | Название | String | Да | - | integration_token_change | |
| translation | Описание | String | Да | - | изменен интеграционный токен | |
| level | Уровень | String | Да | - | critical | |
Endpoint:
GET api-integration.dion.vc/v1/audits/platforms
Список возвращаемых кодов с кратким описанием
Входные параметры: отсутствуют
Выходные параметры:
| Параметр | Описание | Тип | Обязательность | Маскирование | Пример | |
|---|---|---|---|---|---|---|
| items | Массив возможных значений "platform" | [] | ||||
| name | Название | String | Да | - | ||
| translation | Описание | String | Да | - | ||
Endpoint:
GET api-integration.dion.vc/v1/events/params
Метод возвращает все доступные параметры для настройки комнаты при создании/редактировании.
В ответе возвращается массив словарей с настройками.
Параметры ответа:
| Название параметра | Тип поля | Описание |
|---|---|---|
| description | string | Описание настройки |
| name | string | Название настройки. Для изменения настройки именно имя необходимо указывать в массиве event_params |
Схема ответа:
[
{
"description": "string",
"name": "string"
}
]