База знаний: Webinar 3.0
Интеграция сервиса и API
Опубликовано Илья Финогеев on 01 April 2016 16:12

API (Application Programming Interface) в переводе с английского - интерфейс программирования приложений, представляет собой набор готовых функций и методов, с помощью которых можно создавать свои собственные программы/ приложения/ скрипты для работы с сервисом.

Работа с API осуществляется путем направления запросов на специальный URL сервиса (https://userapi.webinar.ru/v3), и получения ответов, содержащих запрошенные данные. Таким образом, API позволяет с помощью таких запросов-ответов выполнять работу с сервисом, как и через web-интерфейс.

Функционал API позволяет интегрировать сервис со своим сайтом, корпоративными системами (СРМ и т.п.), либо создать приложение для управления функционалом сервиса. Например, самый простой и распространенный вариант интеграции - создать форму регистрации на своем сайте, данные, вводимые участниками, с помощью запросов API передавать в сервис вебинаров, получать индивидуальные ссылки для участников, и самостоятельно передавать или рассылать их участникам.

Для подключения функционала API в личном кабинете сервиса необходимо зайти в раздел Бизнес - API, где отправить запрос на его подключение. Для этого необходимо нажать кнопку “Отправить запрос”.

 

После подключения функционала в этом же разделе будет доступен ключ API, который необходим для авторизации при отправке запросов. Здесь же с помощью соответствующей кнопки можно скопировать ключ в буфер обмена, обновить его при необходимости, а также скачать документацию, в деталях описывающих API сервиса.

 

Рассмотрим функционал сервиса, возможность управления которым доступна через API.

 

  1. Мероприятия

  • Возможность создавать, редактировать и удалять мероприятия, как одиночные, так и серийные.

  • Получать информацию о мероприятиях организации или конкретного участника организации. Получать информацию о конкретном мероприятии.

  • Запускать и останавливать мероприятия.

 

2. Контакты (адресная книга)

  • Создание/ обновление / удаление контактов.

  • Поиск контактов.

  • Добавление/ удаление тегов группе контактов.

 

3. Участники

  • Регистрировать участников, как на отдельное мероприятие, так и на все мероприятия серии.

  • Получать список участников мероприятия/ серии.

  • Модерировать участников.

  • Изменить роль участника (участник, ведущий, администратор).

  • Выгнать/ удалить участника.

  • Массовая регистрация до 10 000 участников.

 

4. Записи

  • Получить список записей.

  • Отправить ссылку на запись участникам мероприятия.

  • Поставить запись на конвертацию.

  • Проверить статус конвертации.

  • Удалить запись.

 

5. Чат

  • Отправлять сообщения в чат.

  • Удалять сообщения.

  • Модерировать чат.

  • Получать все сообщения чата.

 

6. Вопросы

  • Получить вопросы.

  • Отправить вопрос/ ответ.

  • Модерировать вопросы.

 

7. Файлы

  • Загружать и удалять файлы.

  • Прикреплять файл к мероприятию.

  • Разрешать доступ к файлу участникам.

 

8. Тесты

  • Создавать, обновлять, удалять тест.

  • Запускать и останавливать тест.

  • Получать результаты теста.

  • Получать статистику пользователя по тестам.

  • Отправить ответы пользователя.

 

9. Статистика

  • Получать статистику по мероприятиям.

  • Получать статистику по участникам.

  • Получать статистику по посещению пользователем мероприятий.

 

10. Получать список участников организации.


Более подробное описание функционала API всегда можно найти в личном кабинете в разделе Бизнес - API.

 

 

 

Подробная документация API доступна в документе по ссылке https://events-storage.webinar.ru/api-storage/files/webinar/system/API.pdf



Вложения 
 
(12 голос(а))
Эта статья помогла
Эта статья не помогла

Комментарии (12)
Андрей
31 May 2016 14:39
Подскажите, у вас, для разработчиков, есть ключ авторизации X-Auth-Token доступ к API? Или обязательно регистрироваться и оплатить?
Максим Ястребов
01 June 2016 16:13
Добрый день!

Ключ API генерируется для аккаунта, поэтому необходимо иметь аккаунт на платформе.
Роман Зыков
16 May 2017 11:18
Исчезла документация pdf файл с вашего портала. Это временно или появились ограничения на использование?
Максим Ястребов
20 May 2017 16:35
Документация доступна по ссылке прямо под статьей. Продублирую здесь:
Подробная документация API доступна в документе по ссылке https://events-storage.webinar.ru/api-storage/files/webinar/system/API.pdf
Роман Зыков
18 August 2017 14:43
Есть ли возможность получать список зарегистрировавшихся пользователей на мероприятие с флагом оплаты (Да/Нет)?
Фёдоров Константин
18 August 2017 20:27
Здравствуйте!

На запрос "GET https://userapi.webinar.ru/v3/eventsessions/EventSessionID/participations" для "EventSessionID" платного вебинара API будет передавать массив зарегистрированных на вебинар слушателей, среди параметров каждого из которых будет строка "paymentStatus", отображающая статус оплаты.

Статусов оплаты три - "оплачен", "не оплачен", "вручную допущен организатором".
Роман Зыков
21 August 2017 16:47
Здравствуйте. Не могу понять как получать EventSessionID?

https://userapi.webinar.ru/v3/organization/events/{$eventId} в ответ возвращается массив данных
Ключ ["eventSessions"] возвращается пустой почти во всех случая, только на одном из $eventId возвращает массив.
Все мероприятия завершены на момент запроса.

После полученный ключ https://userapi.webinar.ru/v3/eventsessions/{$eventSessions}/participations возвращает пустой массив,
Так собственно и запрос https://userapi.webinar.ru/v3/organization/events/schedule возвращает пустой массив.

Что-то не так с настройками? Или с запросами?



Попков Алексей
22 August 2017 13:22
Здравствуйте!
Мы выслали ответ Вам на эл.почту. Если у Вас остались какие-либо вопросы, пожалуйста, ответьте на отправленное Вам письмо.
Андрей
09 October 2017 16:40
Скажите, а куда документация по АПИ делась? Приведенная тут ссылка https://events-storage.webinar.ru/api-storage/files/webinar/system/API.pdf дает 404 ошибку
Попков Алексей
10 October 2017 10:11
Здравствуйте! Пожалуйста, проверьте еще раз. Документация по-прежнему доступна по ссылке https://events-storage.webinar.ru/api-storage/files/webinar/system/API.pdf
Если данный адрес продолжает отдавать ошибку, пожалуйста, напишите нам на почту support@webinar.ru, будем рады помочь! Также, если у Вас есть личный кабинет на платформе events.webinar.ru, Вы можете найти документацию в разделе Бизнес - API.
Сергей Серко
09 October 2017 20:20
Документация не доступна https://events-storage.webinar.ru/api-storage/files/webinar/system/API.pdf

404
Попков Алексей
10 October 2017 10:05
Здравствуйте! Пожалуйста, проверьте еще раз. Документация по-прежнему доступна по ссылке https://events-storage.webinar.ru/api-storage/files/webinar/system/API.pdf
Если данный адрес продолжает отдавать ошибку, пожалуйста, напишите нам на почту support@webinar.ru, будем рады помочь!
Добавить новый комментарий
 
 
Полное имя:
Email:
Комментарии:
Проверка CAPTCHA 
 
Пожалуйста, введите текст с картинки, расположенной ниже. Это необходимо для предотвращения автоматической регистрации и отправки данных через форму.