API для получения списка ваших мероприятий
В некоторых случаях, когда стандартных методов BasePlan не достаточно (например информера), бывает необходимо получить список ваших мероприятий в электронном виде.
Для этого нужно отправить GET или POST запрос по адресу http://baseplan.ru/base/ api_activity_list.php
В зависимости от параметров, вы получите список ваших мероприятий либо в формате ICalendar (ics), либо в формате xCal (iCal xml).
На входе принимаются следующие параметры:
|
Параметр |
Описание |
Тип поля |
|
'a' |
Код компании, описание чуть ниже |
Число |
|
'c' |
Контрольный код, описание чуть ниже |
Строка |
|
'from' |
Дата, начиная с которой будет показано расписание, если не указано, то берется текущая дата (время по MSK!). |
Дата |
|
'to' |
Дата, до которой будет показано расписание (включая это число), если не указано, то берется текущая дата плюс семь дней (время по MSK!). |
Дата |
|
'o' |
Как сортировать мероприятия. 1 - от новых к старым, 2 - от старых к новым. По умолчанию - 1. |
Число |
|
'xml' |
Формат, в котором выводить календарь. Если = 1, то в формате xCal, по умолчанию iCal |
Строка |
Чтобы узнать параметры ‘a’ и ‘c’ нужно зайти в настройки компании (в правом верхнем углу), там кликнуть на зеленую кнопку «Настройка интеграции», потом напротив пункта "Информер" кликнуть на "Настройки", затем на появившейся странице нажать на кнопку «Сохранить и показать».
Чуть ниже, в поле «Код информера для вставки на ваш сайт» появится HTML код для вставки, в нем и нужно искать эти два параметра – на скриншоте сверху они выделены зелёным. В примере параметр ‘a’ = 3, параметр ’c’ = ‘7acf71e199175f7cf71e199631c07190’.
Такой запрос вернет все мероприятия с 1 января по 31 декабря за 2014 год в формате xCal.
Для записи клиентов на какое-то мероприятие можно использовать API для анкет, передавая в act_id номер мероприятия (номер можно узнать из поля UID евента - скажем в поле с UID act_3355_comp_543 номер мероприятия - 3355.