Главная > API документация > Работа с событиями

event/list, event/list/future, event/list/past

Получение списка событий. Параметры "future" и "past" определяют, какие события будут включены в результирующий xml-ответ. Если параметр не указан либо указан "future", то в ответ будут включены еще не наступившие события. Иначе - уже прошедшие.

Параметры:

api_key (обязательное) - API-ключ приложения. Если у Вас еще нет своего API-ключа, то получить его можно здесь.
token (обязательное) - Сеансовый ключ.
limit (необязательное) - Количество записей в одном xml-ответе.
offset (необязательное) - Смещение номера первой записи в списке относительно первой записи в базе данных.

Пример запроса:

http://api.livents.ru/event/list/past/?api_key=<Ваш API-ключ>&token=<Ваш сеансовый ключ>&limit=2


Пример ответа:

<?xml version="1.0" encoding="UTF-8"?>
<rsp result="ok">
<event id="5139" all_day="0" date_begin="2007-01-23" date_end="2007-01-24" 
        time_begin="19:53" time_end="10:00" privacy="public">
    <name><![CDATA[Первое событие]]></name>
    <human_url>http://livents.ru/2007/01/23/pervoe-sobytie/</human_url>
    <user id="1">
        <user_name>login</user_name>
        <first_name>Василий</first_name>
        <last_name>Васильев</last_name>
    </user>
    <location id="1" type="place">
        <name>Центр города</name>
        <locality_id>112</locality_id>
        <locality_name>Центр города, г. Пенза, Россия</locality_name>
        <locality_link>
          <![CDATA[
            <a href="http://livents.ru/place/11321/">Центр города</a>, 
            <a href="http://livents.ru/regions/rus/54/2545/">г. Пенза</a>, 
            <a href="http://livents.fellow/regions/rus/">Россия</a>
          ]]>
        </locality_link>
    </location>
</event>
<event id="5140" all_day="1" date_begin="2007-01-25"
       date_end="2007-02-10" privacy="public">
    <name><![CDATA[Второе событие]]></name>
    <human_url>http://livents.ru/2007/01/25/vtoroe-sobytie/</human_url>
    <user id="1">
        <user_name>login</user_name>
        <first_name>Василий</first_name>
        <last_name>Васильев</last_name>
    </user>
    <location id="1" type="place">
        <name>Центр города</name>
        <locality_id>112</locality_id>
        <locality_name>Центр города, г. Пенза, Россия</locality_name>
        <locality_link>
          <![CDATA[
            <a href="http://livents.ru/place/11321/">Центр города</a>, 
            <a href="http://livents.ru/regions/rus/54/2545/">г. Пенза</a>, 
            <a href="http://livents.fellow/regions/rus/">Россия</a>
          ]]>
        </locality_link>
    </location>
</event>
</rsp>

Атрибуты:

id - Уникальный номер события
all_day - Идет ли событие целый день
date_begin - Дата начала события
date_end - Дата окончания события
time_begin - Время начала события
time_end - Время окончания события
privacy - Статус (доступность) события
human_url - Ссылка на событие
user - Краткое описание пользователя - автора события
name - Название события
(В случае, когда результатом возвращена запись об одном событии, то данные представлены в подробной форме (см. event/info))

event/info

Получение подробного описания события.

Параметры:

api_key (обязательное) - API-ключ приложения. Если у Вас еще нет своего API-ключа, то получить его можно здесь.
token (обязательное) - Сеансовый ключ.
event_id (обязательное) - Уникальный номер события.

Пример запроса:

http://api.livents.ru/event/info/?api_key=<Ваш API-ключ>&token=<Ваш сеансовый ключ>&event_id=5140


Пример ответа:

<?xml version="1.0" encoding="UTF-8"?>
<rsp result="ok">
<event id="5140" all_day="1" date_begin="2007-01-25"
       date_end="2007-02-10" privacy="public">
    <name><![CDATA[Второе событие]]></name>
    <human_url>http://livents.ru/2007/01/25/vtoroe-sobytie/</human_url>
    <category id="1">Общественная жизнь</category>
    <user id="1">
        <user_name>login</user_name>
        <first_name>Василий</first_name>
        <last_name>Васильев</last_name>
    </user>
    <location id="1" type="place">
        <name>Центр города</name>
        <locality_id>112</locality_id>
        <locality_name>Центр города, г. Пенза, Россия</locality_name>
        <locality_link>
          <![CDATA[
            <a href="http://livents.ru/place/11321/">Центр города</a>, 
            <a href="http://livents.ru/regions/rus/54/2545/">г. Пенза</a>, 
            <a href="http://livents.fellow/regions/rus/">Россия</a>
          ]]>
        </locality_link>
    </location>
    <attendees>
        <user id="1">
            <user_name>login</user_name>
            <first_name>Василий</first_name>
            <last_name>Васильев</last_name>
        </user>
        <user id="2">
            <user_name>petro</user_name>
            <first_name>Петр</first_name>
            <last_name>Петров</last_name>
        </user>
    </attendees>
    <watchers>
        <user id="33">
            <user_name>vitaliy</user_name>
            <first_name>Виталий</first_name>
            <last_name>Иванов</last_name>
        </user>
        <user id="44">
            <user_name>sergey</user_name>
            <first_name>Сергей</first_name>
            <last_name>Сергеев</last_name>
        </user>
    </watchers>
</event>
</rsp>

Атрибуты:

id - Уникальный номер события
all_day - Идет ли событие целый день
date_begin - Дата начала события
date_end - Дата окончания события
time_begin - Время начала события
time_end - Время окончания события
privacy - Статус (доступность) события
human_url - Ссылка на событие
user - Краткое описание пользователя - автора события
name - Название события
description - Описание события
home_page - Домашняя страница события
attendees - Список пользователей, учасвтующих в событии
watchers - Список пользователей, наблюдающих за событием

Поиск событий по указанным параметрам

Параметры:

api_key (обязательное) - API-ключ приложения. Если у Вас еще нет своего API-ключа, то получить его можно здесь.
token (обязательное) - Сеансовый ключ.
what (необязательное) - Фраза или слово, которые должны содержаться названии или описании события.
date_start (необязательное) - Дата/время в стандартной форме, относительно которой событие еще не является прошедшим
date_end (необязательное) - Дата/время в стандартной форме, относительно которой событие является прошедшим
limit (необязательное) - Количество записей в одном xml-ответе.
offset (необязательное) - Смещение номера первой записи в списке относительно первой записи в базе данных.

Пример запроса:

http://api.livents.ru/event/search/?api_key=<Ваш API-ключ>&token=<Ваш сеансовый ключ>&limit=2&what=событие


Пример ответа:

<?xml version="1.0" encoding="UTF-8"?>
<rsp result="ok">
<event id="5139" all_day="0" date_begin="2007-01-23" date_end="2007-01-24" 
        time_begin="19:53" time_end="10:00" privacy="public">
    <name><![CDATA[Первое событие]]></name>
    <human_url>http://livents.ru/2007/01/23/pervoe-sobytie/</human_url>
    <user id="1">
        <user_name>login</user_name>
        <first_name>Василий</first_name>
        <last_name>Васильев</last_name>
    </user>
    <location id="1" type="place">
        <name>Центр города</name>
        <locality_id>112</locality_id>
        <locality_name>Центр города, г. Пенза, Россия</locality_name>
        <locality_link>
          <![CDATA[
            <a href="http://livents.ru/place/11321/">Центр города</a>, 
            <a href="http://livents.ru/regions/rus/54/2545/">г. Пенза</a>, 
            <a href="http://livents.fellow/regions/rus/">Россия</a>
          ]]>
        </locality_link>
    </location>
</event>
<event id="5140" all_day="1" date_begin="2007-01-25"
       date_end="2007-02-10" privacy="public">
    <name><![CDATA[Второе событие]]></name>
    <human_url>http://livents.ru/2007/01/25/vtoroe-sobytie/</human_url>
    <user id="1">
        <user_name>login</user_name>
        <first_name>Василий</first_name>
        <last_name>Васильев</last_name>
    </user>
    <location id="1" type="place">
        <name>Центр города</name>
        <locality_id>112</locality_id>
        <locality_name>Центр города, г. Пенза, Россия</locality_name>
        <locality_link>
          <![CDATA[
            <a href="http://livents.ru/place/11321/">Центр города</a>, 
            <a href="http://livents.ru/regions/rus/54/2545/">г. Пенза</a>, 
            <a href="http://livents.fellow/regions/rus/">Россия</a>
          ]]>
        </locality_link>
    </location>
</event>
</rsp>

Атрибуты:

id - Уникальный номер события
all_day - Идет ли событие целый день
date_begin - Дата начала события
date_end - Дата окончания события
time_begin - Время начала события
time_end - Время окончания события
privacy - Статус (доступность) события
human_url - Ссылка на событие
user - Краткое описание пользователя - автора события
name - Название события
(В случае, когда результатом возвращена запись об одном событии, то данные представлены в подробной форме (см. event/info))

event/comments

Просмотр комментариев к событиям.

Параметры:

api_key (обязательное) - API-ключ приложения. Если у Вас еще нет своего API-ключа, то получить его можно здесь.
token (обязательное) - Сеансовый ключ.
event_id (обязательное) - Уникальный номер события.
limit (необязательное) - Количество записей в одном xml-ответе.
offset (необязательное) - Смещение номера первой записи в списке относительно первой записи в базе данных.

Пример запроса:

http://api.livents.ru/event/comments/?api_key=<Ваш API-ключ>&token=<Ваш сеансовый ключ>&event_id=1


Пример ответа:

<?xml version="1.0" encoding="UTF-8"?>
<rsp result="ok">
<comment id="1" date="2007-02-28 04:02">
    <message>Первый комментарий к дискуссии</message>
    <user id="43">
        <user_name>Oleg</user_name>
        <first_name>Олег</first_name>
        <last_name>Иванов</last_name>
    <user>
</comment>
<comment id="2" date="2007-02-28 04:06"  parent_id="1">
    <message>Второй комментарий к дискуссии</message>
    <user id="1235">
        <user_name>Masha</user_name>
        <first_name>Мария</first_name>
        <last_name>Васильева</last_name>
    <user>
</comment>
</rsp>

Атрибуты:

id - Уникальный номер комментария
date - Дата, когда был создан комментарий
parent_id - Уникальной номер родительского комментария, если данный комментарий является ответом на другой
user - Краткое описание пользователя - автора комментария
message - Текст комментария