Изменения в методах API

Документация, обновления, особенности API, работа приложений
Аватара пользователя
Александр
Создатель сайта
Создатель сайта
Сообщения: 4574
Зарегистрирован: 27 сен 2009, 16:45

Изменения в методах API

Сообщение Александр »

friends.get
friends.get - расширенный метод getFriends.
Теперь при использовании параметра fields, возвращает расширенную информацию о друзьях пользователя, без параметра fields - список идентификаторов друзей текущего пользователя, как раньше возвращал метод getFriends.
Появились новые поля: online, lists, domain.

Поле online
Показывает, находится ли этот пользователь сейчас на сайте.
Возвращаемые значения: 1 - находится, 0 - не находится.

Поле lists
Список, содержащий id списков друзей, в которых состоит текущий друг пользователя. Метод получения id и названий списков: friends.getLists. Поле доступно только при вызове метода, возвращающего список друзей пользователя. Если текущий друг не состоит ни в одном списке, то при приёме данных в формате XML в узле <user> отсутствует тег lists.

Поле domain
Возвращает короткий адрес страницы (возвращается только имя адреса, например vitaliy2). Если пользователь не менял адрес своей страницы, возвращается 'id'+uid, например id35828305.

Склонения имени и фамилии пользователя
Указав параметр name_case, можно получить имя пользователя в нужном падеже.
Возможные значения: именительный – nom, родительный – gen, дательный – dat, винительный – acc, творительный – ins, предложный – abl. По умолчанию nom.


friends.getAppUsers
friends.getAppUsers - вместо метода getAppFriends


friends.getLists
friends.getLists - возвращает id и названия списков друзей текущего пользователя. Например: Дом, Работа.


getProfiles
В методе getProfiles, уже достаточно давно появились поля contacts и education.
Если в параметре fields было указано поле contacts, то будут доступны также поля: home_phone, mobile_phone.
Если в параметре fields было указано поле education, то будут доступны также поля: university, university_name, faculty, faculty_name, graduation.

Поле home_phone
Возвращает домашний телефон пользователя (если он указан и доступен).

Поле mobile_phone
Возвращает мобильный телефон пользователя (если он указан и доступен).

Поле university
Возвращает код университета пользователя.

Поле university_name
Возвращает название университета пользователя.

Поле faculty
Возвращает код факультета пользователя.

Поле faculty_name
Возвращает название факультета пользователя.

Поле graduation
Возвращает год выпуска.
Аватара пользователя
psix55
Модератор
Модератор
Сообщения: 1015
Зарегистрирован: 09 дек 2009, 17:16

Re: Изменения в методах API

Сообщение psix55 »

Лично у меня старые методы отлично работают, хотя документации на них уже не нашёл!
Аватара пользователя
Александр
Создатель сайта
Создатель сайта
Сообщения: 4574
Зарегистрирован: 27 сен 2009, 16:45

Re: Изменения в методах API

Сообщение Александр »

psix55
Если бы они отключали старые методы, то многие приложения перестали бы работать)
Аватара пользователя
Александр
Создатель сайта
Создатель сайта
Сообщения: 4574
Зарегистрирован: 27 сен 2009, 16:45

Re: Изменения в методах API

Сообщение Александр »

isAppUser
http://vkontakte.ru/pages.php?o=-1&p=isAppUser
Появился параметр uid - ID пользователя. По умолчанию ID текущего пользователя.
Данный метод возвращает информацию о том, установил ли текущий пользователь приложение или нет.


getProfiles
http://vkontakte.ru/pages.php?o=-1&p=getProfiles
Появился параметр domains - перечисленные через запятую адреса пользователей (используется вместо uids).
Аватара пользователя
Александр
Создатель сайта
Создатель сайта
Сообщения: 4574
Зарегистрирован: 27 сен 2009, 16:45

Re: Изменения в методах API

Сообщение Александр »

Методы для работы со статусом:
activity.get – возвращает последнюю запись пользователя с собственной стены.
activity.set – добавляет сообщение на стену текущего пользователя.
activity.getHistory – возвращает записи пользователя, написанные им на своей стене.
activity.getNews – возвращает обновления записей пользователей на собственных стенах.

занесены в устаревшие.
Аватара пользователя
Александр
Создатель сайта
Создатель сайта
Сообщения: 4574
Зарегистрирован: 27 сен 2009, 16:45

Re: Изменения в методах API

Сообщение Александр »

wall.post - Публикует новую запись на своей или чужой стене.
Параметр attachment
медиа-приложение к записи, представленное в формате:
<type><owner_id>_<media_id>

<type> - тип медиа-приложения:
photo - фотография
video - видеозапись
audio - аудиозапись

<owner_id> - идентфикатор владельца медиа-приложения
<media_id> - идентфикатор медиа-приложения.

Параметр является обязательным, если не задан параметр message.
По описанию можно понять, что отправлять сообщение на стену можно без приложения. Но я не пробовал.
Аватара пользователя
revizor
FL Team
FL Team
Сообщения: 1034
Зарегистрирован: 18 ноя 2009, 20:22

Re: Изменения в методах API

Сообщение revizor »

там со статусами что то 2й день не установить из приложения (
Аватара пользователя
Doker
Модератор
Модератор
Сообщения: 1026
Зарегистрирован: 07 май 2010, 18:53

Re: Изменения в методах API

Сообщение Doker »

Рогозов
на стенах пользователей, теперь доступен для Flash- и IFrame-приложений, использующих Flash-посредник и IFrame API соответственно.

Помимо простого текста к каждой записи может быть прикреплена фотография, видео или аудиозапись, ранее загруженная на сервера ВКонтакте. При этом записи, размещаемые на стене автора, будут попадать в новостную ленту.

Обратите внимание, что метод wall.post может быть вызван только при помощи функции VK.api, встроенной в библиотеку Flash-посредника или IFrame API. Такой подход позволяет нам выводить окно с предварительным просмотром публикуемой записи, всегда давая пользователю возможность подтвердить или отклонить это действие.

Документация доступна по адресу: http://vkontakte.ru/developers.php?o=-1&p=wall.post

С запуском этого метода следующие функции мы считаем устаревшими:
activity.set
activity.get
Начиная с 11.02.2011 включительно эти методы перестанут работать, поэтому мы рекомендуем начать использовать wall.post в ближайшее время.

Чуть позже я расскажу каким образом приложения могут публиковать фотографии на стенах пользователей, не создавая для них отдельные альбомы.
http://vkontakte.ru/topic-1_24039123
Аватара пользователя
revizor
FL Team
FL Team
Сообщения: 1034
Зарегистрирован: 18 ноя 2009, 20:22

Re: Изменения в методах API

Сообщение revizor »

Doker, спасибо , а я паниковал =(
Аватара пользователя
Александр
Создатель сайта
Создатель сайта
Сообщения: 4574
Зарегистрирован: 27 сен 2009, 16:45

Re: Изменения в методах API

Сообщение Александр »

Методы для хранения произвольных данных

storage.get – возвращает значение хранимой переменной.
Возвращает значение переменной, название которой передано в параметре key.
Задать значение позволяет метод storage.set.

Переменные могут храниться в двух областях видимости:
Пользовательская, переменная привязана к пользователю, другие пользователи не могут её прочитать.
Глобальная, переменная привязана к приложению, и работа с ней не зависит от пользователя. Если метод вызывается не от имени приложения, то нужно передать параметр global для доступа к переменной.


storage.set – сохраняет значение хранимой переменной.
Сохраняет значение переменной, название которой передано в параметре key.
Ответить