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

category/list

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

Параметры:

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

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

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


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

<?xml version="1.0" encoding="UTF-8"?>
<rsp result="ok">
<category id="1"><![CDATA[Первая категория]]></category> <category id="2"><![CDATA[Вторая категория]]></category> <category id="3" parent_id="2"><![CDATA[Третья категория]]></category> <category id="4" parent_id="2"><![CDATA[Четвертая категория]]></category>
</rsp>

Атрибуты:

id - Уникальный номер категории
parent_id - Уникальный номер родительской категории
category - Название категории

category/events, category/events/future, category/events/past

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

Параметры:

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

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

http://api.livents.ru/category/events/past/?api_key=<Ваш API-ключ>&token=<Ваш сеансовый ключ>&limit=3&category_id=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))