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

user/info

Просмотр информации о пользователе.

Параметры:

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

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

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


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

<?xml version="1.0" encoding="UTF-8"?>
<rsp result="ok">
<user id="1234" sex="m" birthday="1985-04-03">
    <user_name>login</user_name>
    <first_name>Василий</first_name>
    <last_name>Васильев</last_name>
    <biography><![CDATA[Биография]]></biography>
    <phone>123-45-67</phone>
    <home_page>http://ww.vasilij.ru</home_page>
    <livejournal>vasilij</livejournal>
    <im type="ICQ">123123123</im>
</user>
</rsp>

Атрибуты:

id - Уникальный номер пользователя
user_name - Никнейм пользователя
first_name - Имя пользователя
last_name - Фамилия пользователя
phone - Телефон
sex - Пол пользователя
birthday - Дата рождения пользователя в формате "YYYY-MM-DD"
home_page - Домашняя страница
im - идентификатор клиента (type - имя клиента. Возможные клиенты: ICQ, Jabber, Msn)
live_journal - Страница LifeJournal
biography - Биография пользователя
(Если поле не имеет значение, то оно не входит в результирующий xml-ответ)

user/list

Получение списка пользователей.

Параметры:

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

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

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


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

<?xml version="1.0" encoding="UTF-8"?>
<rsp result="ok">
<user id="1234">
    <user_name>login</user_name>
    <first_name>Василий</first_name>
    <last_name>Васильев</last_name>
<user>
<user id="1235">
    <user_name>Masha</user_name>
    <first_name>Мария</first_name>
    <last_name>Васильева</last_name>
<user>
</rsp>

Атрибуты:

id - Уникальный номер пользователя
user_name - Никнейм пользователя
first_name - Имя пользователя
last_name - Фамилия пользователя
(В случае, когда результатом возвращена запись об одном пользователе, то данные представлены в подробной форме (см. user/info))

user/events, user/events/future, user/events/past

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

Параметры:

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

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

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

user/friends

Получение списка друзей пользователя.

Параметры:

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

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

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


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

<?xml version="1.0" encoding="UTF-8"?>
<rsp result="ok">
<user id="55">
    <user_name>igor</user_name>
    <first_name>Игорь</first_name>
    <last_name>Михайлов</last_name>
<user>
<user id="88">
    <user_name>Masha</user_name>
    <first_name>Мария</first_name>
    <last_name>Васильева</last_name>
<user>
</rsp>

Атрибуты:

id - Уникальный номер пользователя
user_name - Никнейм пользователя
first_name - Имя пользователя
last_name - Фамилия пользователя
(В случае, когда результатом возвращена запись об одном пользователе, то данные представлены в подробной форме (см. user/info))

user/friends/add

Добавление пользователя в свой список друзей. Результат запроса - обновленный список друзей.

Параметры:

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

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

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


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

<?xml version="1.0" encoding="UTF-8"?>
<rsp result="ok">
<user id="55">
    <user_name>igor</user_name>
    <first_name>Игорь</first_name>
    <last_name>Михайлов</last_name>
<user>
<user id="88">
    <user_name>Masha</user_name>
    <first_name>Мария</first_name>
    <last_name>Васильева</last_name>
<user>
<user id="7">
    <user_name>ivan</user_name>
    <first_name>Иван</first_name>
    <last_name>Иванов</last_name>
<user>
</rsp>

Атрибуты:

id - Уникальный номер пользователя
user_name - Никнейм пользователя
first_name - Имя пользователя
last_name - Фамилия пользователя
(В случае, когда результатом возвращена запись об одном пользователе, то данные представлены в подробной форме (см. user/info))

user/friends/delete

Удаление пользователя из своего списка друзей. Результат запроса - обновленный список друзей.

Параметры:

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

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

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


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

<?xml version="1.0" encoding="UTF-8"?>
<rsp result="ok">
<user id="55">
    <user_name>igor</user_name>
    <first_name>Игорь</first_name>
    <last_name>Михайлов</last_name>
<user>
<user id="7">
    <user_name>ivan</user_name>
    <first_name>Иван</first_name>
    <last_name>Иванов</last_name>
<user>
</rsp>

Атрибуты:

id - Уникальный номер пользователя
user_name - Никнейм пользователя
first_name - Имя пользователя
last_name - Фамилия пользователя
(В случае, когда результатом возвращена запись об одном пользователе, то данные представлены в подробной форме (см. user/info))

user/interests

Просмотр списка интересов пользователя.

Параметры:

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

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

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


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

<?xml version="1.0" encoding="UTF-8"?>
<rsp result="ok">
<interest id="1"><Первый интерес></interest>
<interest id="2"><![CDATA["Второй интерес"]]></interest>
</rsp>

Атрибуты:

id - Уникальный номер интереса
interest - Название интереса пользователя