Обновление VK API: главные изменения для разработчиков

Обновление API ВКонтакте: что изменилось и что важно для разработчиков

VK выпустил обновления API — с версии 4.0 до 5.199. Изменения затронули методы для работы с рекламой, сообщениями, товарами, историями, статистикой, приложениями, профилями и сообществами. В этой статье разбираем ключевые изменения, которые важно учитывать при разработке, и объясняем, как они влияют на код.

Что важно знать в первую очередь

Начиная с версии 5.56 запросы к api.vk.com можно отправлять только по HTTPS.

С версии 5.76 прекращена поддержка ответов в XMLформате.

В версии 5.90 параметр randomid в методе messages.send стал обязательным.

В версии 5.138 параметр userids в messages.send помечен как deprecated — используйте peerids.

В версии 5.103 у события messagenew в Callback API и LongPoll API изменилась структура: вместо { object: message } приходит { object: { message, clientinfo } }.

Реклама (ads.)

В ads.createClients и ads.updateClients добавлен параметр orddata для сохранения данных клиента по объекту оператора рекламных данных (ОРД). Метод ads.getClients возвращает эти данные в поле orddata (5.194).

Для ads.createTargetGroup и ads.updateTargetGroup параметр lifetime стал обязательным и принимает значения от 1 до 720 (5.102).

В ads.getStatistics поле goals заменено на leadformsends (5.105).

В ads.getAds поле impressionslimit заменено на impressionslimit и impressionslimited, а поле disclaimer разделено на disclaimermedical, disclaimerspecialist, disclaimersupplements (5.50).

Метод ads.getAdsPostsReach отключен, вместо него используйте ads.getPostsReach (5.103).

Сообщения (messages.)

Появился новый API для сообщений: изменился объект message, добавлен объект conversation (5.80).

Устаревшие методы messages.getDialogs, messages.getChat, messages.getChatUsers, messages.get, messages.searchDialogs больше обновляться не будут (5.80).

Методы messages.markAsImportantDialog, messages.markAsAnsweredDialog, messages.deleteDialog перенаправляются на новые версии с Conversation (5.80).

В messages.markAsRead параметр startcmid переименован в uptocmid (5.193).

В messages.send параметр userids заменен на peerids (5.138).

В объекте сообщения появились поля payload (5.114), template (5.111), iscropped (5.102), а также новый тип вложения narrative — сюжет (5.154).

В messages.removeChatUser добавлен параметр memberid (5.81).

Товары и магазины (market.)

В market.add и market.edit добавлено поле sku — артикул товара (5.131).

В market.getOrderItems добавлен опциональный параметр userid (5.131).

В market.editOrder добавлены поля deliveryprice, tracknumber, paymentstatus, а также width, length, height, weight (5.130).

В объекте товара появились dimensions, oldamount, oldamounttext (5.120, 5.106, 5.126).

Изменился формат market.getCategories: теперь возвращается вложенное дерево категорий, поля offset и count устарели (5.139).

В market.getById поле category вместо section использует parent (5.139).

Истории (stories.)

Изменился процесс загрузки историй: stories.getPhotoUploadServer и stories.getVideoUploadServer возвращают только uploadresult, который нужно передать в stories.save (5.118).

В stories.get, stories.getReplies, stories.search возвращается новый формат ленты историй (5.113).

В stories.getViewers в items теперь массив объектов с полями isliked и userid (5.115).

Порядок историй в stories.get менялся: в 5.82 — реверсивный, в 5.102 — хронологический.

Профили, сообщества и подписки

В объекте пользователя добавлены обязательные поля isclosed и canaccessclosed (5.89).

В groups.getById изменен формат ответа: возвращаются groups и profiles, в объект группы добавлено поле like (5.139).

В groups.get в объекте market поле type принимает значения basic и advanced (5.124).

В объекте сообщества поля wall получили новые значения: 2 — ограничена, 3 — закрыта (5.87).

Появились методы VK Donut: donut.isDon, donut.getFriends, donut.getSubscription, donut.getSubscriptions (5.125).

Статистика и приложения

В stats.get параметры datefrom и dateto заменены на timestampfrom и timestampto, добавлен параметр statsgroups (5.86).

В объекте приложения type принимает новые значения: app, game, site, standalone, vkapp, communityapp, html5game (5.85).

В apps.get добавлены поля mobilecontrolstype и mobileviewsupporttype (5.105).

В apps.getActivity для типа achievement добавлен объект media с изображениями (5.105).

Что делать разработчикам

1. Обновите используемую версию API до актуальной. Следите за официальным списком версий: https://dev.vk.ru/ru/reference/versions.

2. Проверьте код на использование устаревших методов и параметров: messages.getDialogs, messages.searchDialogs, userids в messages.send, guid вместо randomid.

3. Учитывайте изменения форматов ответов: например, wall.getById без extended теперь возвращает items, market.getCategories возвращает дерево.

4. Для рекламных интеграций проверьте новые поля и обязательные параметры.

Полезно: документация или схема помогают быстрее заметить новые возможности и уточнения API.

Риск: изменение контракта может потребовать правок в интеграции, генерации типов или пользовательских сценариях.