Интеграция сервиса и API
Опубликовано Accounting Department on 12 December 2012 20:24

API сервиса Webinar.ru представляет из себя простой HTTP-XML интерфейс. 
Для работы с API требуются базовые знания XML, а также любого языка программирования (perl, python, php, apsx и др).

С помощью API Вы сможете интегрировать сервис в свои внутренние корпоративные системы (CRM, ERM и пр), интернет-сайты. Доступны несколько методов для интеграции, это создание мероприятий, регистрация пользователей и администраторов на мероприятия.

Для доступа к API требуется ключ авторизации. Ключ авторизации можно найти в личном кабинете, в разделе "Настройки". Если у Вас ключ ещё не сгенерирован, нажмите кнопку "Сгенерировать".

С полным списком возможностей API сервиса Webinar.ru можно ознакомиться в документации.



Вложения 
 
 apiwebinar.ru.doc (91.50 КБ)
(41 голос(а))
Эта статья помогла
Эта статья не помогла

Комментарии (45)
Кондаурова Ирина
11 November 2013 13:43
Требуется ключ авторизации для доступа к API.
Alexander Brovko
19 November 2013 17:54
Здравствуйте!

Для получения ключа авторизации для доступа к API, пожалуйста, напишите на support@webinar.ru, с указанием Вашего логина в системе.
Ольга Земскова
25 March 2014 15:13
Добрый день!

Подскажите, есть ли (либо планируется в будущем) возможность посредством API:
1) получить список своих вебинаров, желательно со статусами;
2) получить детали вебинара (название, описание и т.д.) по его ID?
Александр Бровко
26 March 2014 10:58
Здравствуйте!

Безусловно, функционал API будет расширен в следующих обновлениях. Указанный Вами функционал будет доступен для использования.
Ольга Земскова
27 March 2014 11:49
А не могли бы Вы сориентировать по срокам, когда ждать нового релиза?
Александр Бровко
27 March 2014 16:13
Здравствуйте!

К сожалению, на данный момент мы не можем назвать точных сроков выхода обновленного API, релиз запланирован на текущий год.
Владимир Ковальчук
24 June 2014 13:53
Здравствуйте. При регистрации на вебинар какое может быть значение role? Какие могут быть статусы получаемые при getStatus
Александр Бровко
24 June 2014 15:18
Здравствуйте!

"Role" принимает значения "user" или "administrator", "getStatus" имеет значения "START" - мероприятие начато, "STOP" - мероприятие закончено, "Event not found" - некорректный ID вебинара, " " - вебинар удален.
Павел
18 September 2014 13:16
Регистрация участников по API не поддерживает передачу email? Как так?
Александр Бровко
22 September 2014 13:23
Добрый день!

На данный момент, Вы можете собирать email на стороне своего ресурса. Выпуск расширенного функционала пользовательского API запланирован на начало следующего года.
Антон
04 March 2015 10:23
Добрый день! Будет ли на новой платформе такой-же API?
Максим Ястребов
10 March 2015 16:46
Добрый день, Антон!

В новой версии сервиса будет своя версия API.
Мария
20 March 2015 17:12
Регистрация участников по API по-прежнему так и не поддерживает передачу email?
Когда будет внедрен этот функционал? Обещали в начале года.
Максим Ястребов
23 March 2015 16:16
Добрый день, Мария!

К сожалению, передача email при регистрации участников посредством функционала API, пока не реализована.
Все изменения и пожелания по новому функционалу планируется реализовать в новой версии сервиса, которая в настоящее время находится в разработке.
О выходе новой версии Вы сможете узнать из наших новостей.
Иванов Иван
08 June 2015 10:34
В документации к API:
1) не указан формат ответа в случае, если запрос прошел неуспешно
2) не указан формат ответа в случае успешного старта/завершения вебинара
3) в запросах о удалении пользователя и проверке его статуса в качестве примера ответа указан некорректный xml
как можно получить корректную информацию по этим пунктам?
Максим Ястребов
08 June 2015 14:49
Добрый день, Иван!

1. Непонятно, о каком именно запросе и ответе идет речь.

2. В случае успешного старта/завершения вебинара формат ответа аналогичен ответу в случае удаления мероприятия:
<?xml version="1.0"?>
<event status="ok" event_id="{EVENT_ID}"/>

3. Уточните, пожалуйста, где именно указан некорректный xml?
При проверке статуса пользователя, в случае подтверждения:
<?xml version="1.0"?>
<record status="ok"/>
<user role="user"/>
Если пользователь не зарегистрирован:
<?xml version="1.0" ?>
<record status="error" description="User not found" />
При удалении участника:
<?xml version="1.0"?>
<record status="ok"/>
<user user_id="id_участника"/>
Все ответы соответствуют указанным в документации.
Иванов Ивано
08 June 2015 15:48
1. Речь идет о синтаксически верном но логически некорректном запросе. Например, если мы попытаемся создать вебинар в прошлом. Или удалить вебинар который уже удалили. Или удалить человека, которого уже удалили. В этом случае будет 200 OK и xml, описывающий ошибку или 400 Bad Request? Или какой-то третий вариант?
3. <?xml version="1.0"?>
<record status="ok"/>
<user role="user"/>
В xml может быть только один root элемент, а значит эта конструкция не является корректной xml записью. И как результат - библиотеки для работы с xml отказываются обрабатывать эту запись.
Это все-таки в документации ошибка или сервис и правда генерирует некорректный xml?
Максим Ястребов
09 June 2015 12:14
Иван!

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

3. Спасибо за найденную проблему. В работу сервиса внесены изменения, теперь при таких запросах генерируется корректный xml. В документацию будут внесены изменения в течение сегодняшнего дня.
Иванов Иван
09 June 2015 13:43
Извиняюсь за занудство, но "корректный ответ об ошибке, что участник не найден" это что? В документации про это не слова. А ведь это может быть 400 Bad Request с описание, 404 Not Found с описанием, 200 OK с xml с сообщением об ошибке.
Максим Ястребов
11 June 2015 10:42
Иван!

В документации конкретно указано:
<?xml version="1.0"?>
<user status="error" description="User not found"/>
Татьяна
24 July 2015 12:33
Можно ли закрыть доступ к записям вебинара не удаляя сам вебинар из календаря мероприятий?
Максим Ястребов
24 July 2015 16:49
Добрый день, Татьяна!

В настройках вебинара вы можете установить предварительную регистрацию, либо вход по паролю, в таком случае для доступа к записи потребуется уникальная ссылка, которая известна только Вам, и без этой ссылки запись будет недоступна для просмотра.
Татьяна
27 July 2015 11:34
Спасибо. Это понятно. Имелось в виду, можно ли ограничить просмотр или закрыть доступ, в общем сделать что-то со ссылкой записи, которая уже отправлена слушателю, чтобы он мог ею пользоваться ограниченное время, но все это сделать без удаления самого вебинара из календаря завершенных мероприятий? Заранее спасибо.
Максим Ястребов
28 July 2015 18:14
Добрый день!

Изменить ссылку на запись, или установить ее действие по времени, к сожалению, нельзя.
Сергей Нагайцев
04 August 2015 14:16
Добрый день, хотелось бы узнать, можно ли как-то получить данные о том, сколько времени пользователь смотрел вэбинар. Например вэбинар шёл с 13 00 до 14 00, а пользователь зашел в 13:40 и вышел в 13:41, и нужно понимать что он был всего минуту.
Максим Ястребов
05 August 2015 10:27
Добрый день!

Подробную статистику по пользователям, в том числе время входа и выхода каждого, можно получить в разделе статистика (https://support.webinar.ru/index.php?/Knowledgebase/Article/View/397/82/sttistik) из файла, полученного по ссылке "Скачать в CSV".
Валерия Куценко
02 September 2015 13:00
С полным списком возможностей API сервиса Webinar.ru можно ознакомиться в документации.С полным списком возможностей API сервиса Webinar.ru можно ознакомиться в документации.

Добрый день, где я могу найти данную документацию?
Максим Ястребов
02 September 2015 13:04
Добрый день!

Файл apiwebinar.ru.doc (91.00 КБ) приложен к статье.
Валерия Куценко
02 September 2015 13:03
Нашла документацию во вложении, спасибо.
Дмитрий Гончаровd
23 September 2015 09:24
Доброго времени суток!
Подскажите пожалуйста запрос на удаление участника из конференции. В документации опечатка

http://my.webinar.ru/api0/User.php?key={key}&email={email}&event_id={eventId}
Максим Ястребов
23 September 2015 10:22
Добрый день!

Для удаления участника из мероприятия необходимо отправить следующий REST запрос:
DELETE http://my.webinar.ru/api0/User.php?key={key}&email={email}&event_id={eventId}

Уточните, пожалуйста, где именно Вы наши опечатку?
Мария
12 October 2015 20:23
Регистрация участников по API по-прежнему так и не поддерживает передачу email?
Максим Ястребов
13 October 2015 12:46
Добрый день, Мария!

Передача email при регистрации участников через api поддерживается. Вся необходимая информация есть в документации.
Сергей Нагайцев
15 January 2016 12:03
Добрый день, а не планируется в будущем в API встроить выгрузку статистики по пользователям. Очень неудобно сейчас парсить файлы
Максим Ястребов
15 January 2016 12:29
Добрый день, Сергей!

Реализация такого функционала планируется в API для новой версии нашего сервиса (https://events.webinar.ru), релиз которого запланирован на ближайшее время. В настоящее время сервис находится в стадии beta-тестирования, и открытого API для него пока нет. API будет доступен после релиза.
Олег
25 January 2016 15:28
Добрый день.

Подскажите, был ли реализован в API метод получения списка семинаров?

>Ольга Земскова
>25 March 2014 15:13
>Подскажите, есть ли (либо планируется в будущем) возможность посредством API:
>1) получить список своих вебинаров, желательно со статусами;
Максим Ястребов
25 January 2016 17:36
Добрый день, Олег!

Указанный функционал будет реализован в API к новой версии нашего сервиса, релиз которого запланирован на самое ближайшее время.
Ruslan
28 January 2016 16:22
Добрый день!

Подскажите, пожалуйста, почему при удалении пользователя из мероприятия я получаю такой респонс - <user status="error" description="wrong api key"></user>? С этим ключем я создаю мероприятие, добавляю юзеров, а при удалении такое сообщение...
Максим Ястребов
28 January 2016 17:19
Добрый день, Руслан!

Убедитесь, пожалуйста, что используется действительно корректный ключ, он не содержит пробелов, символов кириллицы и других некорректных символов. Также необходимо убедиться, что используется корректный DELETE-запрос:
DELETE http://my.webinar.ru/api0/User.php?key={key}&email={email}&event_id={eventId}

В случае, если это не поможет, пришлите, пожалуйста, точный текст запроса с описанием проблемы на адрес support@webinar.ru
Ярослав
28 January 2016 21:28
Когда выйдет новая версия АПИ?
Максим Ястребов
29 January 2016 13:00
Добрый день, Ярослав!

Новая версия API выйдет после релиза новой версии сервиса, который, в свою очередь, запланирован на февраль т.г.
Следите за нашими новостями!
Егор
08 March 2016 07:15
Здравствуйте!

уже март, когда можно будет ознакомиться с новой версией API?
Максим Ястребов
09 March 2016 18:31
Добрый день, Егор!

Релиз API для новой версии нашего сервиса запланирован на март-апрель текущего года.
Следите за нашими новостями!
Руслан
25 October 2016 08:42
Здравствуйте, можете помочь с вопросом, как обработать ответ сервера, если при добавлении учащегося в мероприятие через api сервер передает ссылку на мероприятие xml формате, как мне получить эту ссылку на php?
Максим Ястребов
25 October 2016 11:44
Добрый день!

Вы можете найти информацию об этом, например, по такому запросу: https://www.google.ru/#newwindow=1&q=%D0%BF%D0%B0%D1%80%D1%81%D0%B8%D0%BD%D0%B3+xml+php
Добавить новый комментарий
 
 
Полное имя:
Email:
Комментарии:
Проверка CAPTCHA 
 
Пожалуйста, введите текст с картинки, расположенной ниже. Это необходимо для предотвращения автоматической регистрации и отправки данных через форму.