Будь в курсе!
API позволяет работать с данными сервиса ActionList.ru. Вы сможете получать самую полную, оперативную и структурированную информацию о концертах, клубах и музыкальных исполнителях. ActionList API - это автоматизированный доступ к самой полной концертной афише и информации о концертах Москвы, Киева и других городов. API работает по протоколу HTTP через GET-запросы, ответ возвращается в формате XML.
Доступ к ActionList API это:
Текущая версия ActionList API: 2.0
Для получения доступа к API необходимо отправить заявку по адресу [email protected].
Все запросы к API необходимо отправлять по адресу https://api.actionList.ru/v2/.
Для доступа к API Вы получите авторизационный ключ, который необходимо включать в каждый запрос к API(переменная auth). Запросы от неавторизованных пользователей будут отклонены. Сессия назначается для всего приложения и является постоянной.
Для получения доступа к API необходимо написать запрос по адресу [email protected].
В текущей версии ActionList API доступны следующие запросы:
| GetEvents | Возвращает описание всех предстоящих мероприятий. |
| GetEventInfo | Возвращает описание конкретного мероприятия. |
| GetArtistInfo | Возвращает описание конкретного исполнителя. |
| GetSimilarArtists | Возвращает список похожих по репертуару музыкальных исполнителей. |
| SearchArtist | Возвращает список исполнителей с учетом названия или музыкального жанра. |
| GetClubs | Возвращает описание всех клубов. |
| GetClubInfo | Возвращает описание конкретного клуба. |
| GetGenres | Возвращает список всех музыкальных жанров. |
С планами развития ActionList API можно ознакомиться в разделе RoadMap. API может быть доработано под требования заказчика.
Запрос c параметром all возвращает XML структуру с описанием всех предстоящих мероприятиях, упорядоченных по времени.
Пример запроса:https://api.actionlist.ru/v2/?GetEvents=all&auth=%token% - возвращает список всех предстоящих концертов.
Существует возможность фильтровать список мероприятия. Для этого необходимо воспользоваться запросом с параметром part и дополнительными фильтрами. Фильтры можно использовать как по отдельности, так и вместе:https://api.actionlist.ru/v2/?GetEvents=part&club_id=12&min_date=20.12.2012&max_date=30.12.2012&auth=%token%
Дополнительные фильтры:
| club_id | Вывести концерты, проходящие в определенном клубе. |
| day | Вывести концерты проходящие в конкретный день(формат дд.мм.гггг). |
| min_date | Ограничение снизу на дату концерта(формат дд.мм.гггг). |
| max_date | Ограничение сверху на дату концерта(формат дд.мм.гггг). |
Пример XML-ответа:
<events> <event> <id>560</id> <title>Ария</title> <date>13.04.2013 20:00</date> <timestamp>1365868800</timestamp> <club> <club_id>11</club_id> <club_name>Arena Moscow</club_name> <club_adress>Ленинградский проспект 31 стр.4</club_adress> <club_geo>55.784765:37.560043</club_geo> <club_phone>+7 (495) 940 67 55</club_phone> <club_logo>http://actionlist.ru/img/club/11.jpg</club_logo> <club_url>http://actionlist.ru/clubs/club/16_tons</club_url> </club> <images> <afisha>http://actionlist.ru/img/event/560.jpg</afisha> <afisha_small>http://actionlist.ru/img/event/560_sm.jpg</afisha_small> </images> <genres> <genre>heavy metal</genre> <genre>metal</genre> <genre>rock</genre> <genre>russian</genre> </genres> <ticket>http://ponominalu.ru/event/id/472953?promote=actionlist</ticket> <description>13 апреля в Москве, в клубе «Arena Moscow» состоится большой сольный концерт «Ария» - главной «тяжелой» группы страны. Теперь и московские поклонники получат возможность услышать новую программу коллектива, с которой коллектив уже активно гастролирует по стране. Предстоящий концерт «Ария» в Москве в рамках тура «Феникс» будет посвящен новому периоду в творческой жизни группы, а в частности выходу одноименной пластинки. </description> <cancellation>0</cancellation> <url>http://actionlist.ru/events/event/aria_13.04</url> </event> ... </events>
Запрос возвращает XML структуру с описанием конкретного концерта.
Пример запроса:https://api.actionlist.ru/v2/?GetEventInfo&id=4199&auth=%token% - возвращает описание концерта с ID 4199.
Параметры:
| id | ID концерта в системе. |
Запрос возвращает XML структуру с описанием конкретного музыкального исполнителя.
Пример запроса по ID:https://api.actionlist.ru/v2/?GetArtistInfo&id=112&auth=%token% - возвращает описание исполнителя с ID 112.
Пример запроса по имени:https://api.actionlist.ru/v2/?GetArtistInfo&name=2pac&auth=%token% - возвращает описание исполнителя 2pac.
Параметры:
| id | ID исполнителя. |
| name | Имя исполнителя. |
Пример XML-ответа:
<artistinfo> <id>112</id> <name>2Pac</name> <year>1990</year> <leader></leader> <country>США</country> <city>Нью-Йорк</city> <site>http://2pac.com</site> <download>http://rutracker.org/forum/viewtopic.php?t=3812451</download> <youtube>http://youtube.com/artist/2pac?feature=watch_video_title </youtube> <images> <main_photo>http://actionlist.ru/img/artist/112/0.jpg</main_photo> <main_photo_small>http://actionlist.ru/img/artist/112/0_sm.jpg</main_photo_small> <photo>http://actionlist.ru/img/artist/112/1.jpg</photo> <photo>http://actionlist.ru/img/artist/112/2.jpg</photo> <photo>http://actionlist.ru/img/artist/112/3.jpg</photo> <photo>http://actionlist.ru/img/artist/112/4.jpg</photo> <photo>http://actionlist.ru/img/artist/112/5.jpg</photo> <photo>http://actionlist.ru/img/artist/112/6.jpg</photo> <photo>http://actionlist.ru/img/artist/112/7.jpg</photo> <photo>http://actionlist.ru/img/artist/112/8.jpg</photo> <photo>http://actionlist.ru/img/artist/112/9.jpg</photo> </images> <genres> <genre>rap</genre> </genres> <description>Нельзя полностью рассказать о жизни Тупака.....</description> <url>http://actionlist.ru/artists/artist/2pac</url> </artistinfo>
Запрос возвращает XML структуру со списком музыкальных исполнителей, которые соответствуют критерию.
Пример поиска по Имени:https://api.actionlist.ru/v2/?SearchArtist&name=Band&auth=%token% - возвращает список исполнителей со словом "Band" в названии.
Пример поиска по Жанру:https://api.actionlist.ru/v2/?SearchArtist&genre=1&auth=%token% - возвращает список исполнителей определенного жанра(жанр с ID 1).
Параметры:
| name | Имя исполнителя. |
| genre | ID музыкального жанра. |
Пример XML-ответа:
<searchartist> <artist> <id>2416</id> <name>Band of Horses</name> </artist> <artist> <id>2419</id> <name>Banda Bassotti</name> </artist> ... </searchartist>
Запрос возвращает XML структуру со списком исполнителей, музыкальный репертуар которых близок к репертуару указанного музыканта.
Параметры:
| name | Имя исполнителя. |
| ID | ID исполнителя. |
Пример поиска по Имени:https://api.actionlist.ru/v2/?GetSimilarArtists&name=2pac&auth=%token% - возвращает список исполнителей похожих на 2pac.
Пример поиска по ID:https://api.actionlist.ru/v2/?GetSimilarArtists&id=112&auth=%token% - возвращает список исполнителей похожих на исполнителя с ID 112.
Пример XML-ответа:
<similarartists> <artist> <id>23637</id> <name>Thug Life</name> </artist> <artist> <id>17001</id> <name>Outlawz</name> </artist> ... </similarartists>
Запрос возвращает XML структуру с описанием конкретного мероприятия.
Пример запроса:https://api.actionlist.ru/v2/?GetClubs=all&auth=%token% - возвращает описание всех клубов.
Пример XML-ответа:
<clubs> <club> <id>1</id> <name>FM Club</name> <city>1</city> <adress>Земляной вал, д. 60/28</adress> <metro>Таганская</metro> <geo>55.752485:37.656234</geo> <site>http://fm-club.su/</site> <phone>+7(495) 502-99-21 </phone> <images> <club_logo>http://actionlist.ru/img/club/1.jpg</club_logo> <club_logo_small>http://actionlist.ru/img/club/1_sm.jpg</club_logo_small> </images> <description>First Music Club - музыкальный ночной клуб Москвы, который продолжает хорошую традицию клубов, созданных профессионалами для профессионалов.</description> <url>http://actionlist.ru/clubs/club/fm_club</url> </club> .... </clubs>
Запрос возвращает XML структуру с описанием конкретного клуба.
Пример запроса:https://api.actionlist.ru/v2/?GetClubInfo&id=1&auth=%token% - возвращает описание клуба с ID 1.
Параметры:
| ID | ID клуба. |
Запрос возвращает XML структуру со списком музыкальных жанров.
Пример запроса:https://api.actionlist.ru/v2/?GetGenres&auth=%token% - возвращает список всех музыкальных жанров.
Пример XML-ответа:
<genres> <genre> <id>1</id> <name>8 bit</name> </genre> <genre> <id>2</id> <name>acid</name> </genre> ... </genres>
29.05.2015 в запросы GetEvents и GetEventInfo добавлен тег ticket, который содержит ссылку на покупку билета на концерт.
ActionList API может быть доработан под требования конкретного заказчика.
В данный момент идет разработка следующего функционала для API: