VK API: история изменений версий 4.0–5.199

История изменений VK API: версии 4.0–5.199

В справочнике VK собраны изменения API от версии 4.0 до 5.199: новые и устаревшие методы, переименования параметров, новые поля объектов и изменения форматов ответа.

В последней указанной версии — 5.199 — публичный контракт API не изменился. VK обновила внутренние алгоритмы обработки некоторых запросов, но состав методов, параметры и возвращаемые значения остались прежними.

Что изменилось в последних версиях

VK API 5.199

Изменены внутренние алгоритмы обработки некоторых запросов. Разработчикам не требуется менять вызовы методов, параметры или обработку ответов только изза перехода на 5.199.

VK API 5.195

В методе video.edit изменён формат ответа. Интеграциям, использующим этот метод, следует проверить десериализацию результата и тесты, завязанные на прежнюю структуру.

VK API 5.194

Изменения затронули рекламу и предварительный просмотр чатов:

в ads.createClients и ads.updateClients добавлен параметр orddata для данных клиента по объекту оператора рекламных данных;

ads.getClients возвращает эти данные в поле orddata;

messages.getChatPreview возвращает chatsettings.state = out и joined = false, если пользователь никогда не состоял в чате.

VK API 5.193

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

В глобальном поиске мобильного приложения блок миниприложений получил название «Сервисы».

VK API 5.192

В database.getSchoolClasses изменён формат ответа. Код, который напрямую разбирает структуру результата, необходимо сверить с форматом этой версии.

Значимые изменения версий 5.154–5.120

Сообщения и вложения

В версии 5.154 методы messages. получили новый тип вложения — сюжет (narrative).

В версии 5.141 в объект заказа добавлено поле isviewedbyadmin.

Сообщества и категории товаров в 5.139

В groups.getById изменён формат ответа. В response возвращаются:

groups — сведения о сообществах;

profiles — сведения о пользователях, отметивших сообщество отметкой «Нравится».

В объект группы также добавлено поле like.

Метод market.getCategories теперь возвращает в response полное вложенное дерево категорий. Поля offset и count помечены как deprecated.

В market.getById изменена структура category: вместо обязательного section используется необязательное поле parent. Оно может содержать следующий parent; если родителя нет, поле не возвращается.

Унификация ответов и устаревший userids в 5.138

Результат wall.getById при extended = 0 теперь обёрнут в items, как и при extended = 1.

Параметр userids метода messages.send помечен как deprecated. Вместо него рекомендуется использовать peerids.

Новый ответ newsfeed.ignoreItem в 5.137

В response возвращаются:

обязательное поле status типа boolean;

необязательное поле message типа string.

Изменения VK Market в 5.131–5.120

В версии 5.131 поле sku добавлено в market.add, market.edit и объект item, возвращаемый методами market.getOrderItems, market.getOrderById и market.get. В market.getOrderItems также появился необязательный параметр userid.

В версии 5.130 метод market.editOrder получил поля:

deliveryprice;

tracknumber;

paymentstatus;

width;

length;

height;

weight.

Поле merchantcomment сохраняет комментарий продавца.

В версии 5.126 в объекте цены товара появилось oldamounttext, а в версии 5.120 — объект dimensions с габаритами и весом товара.

В версии 5.122 поля товара date и viewscount стали возвращаться только администратору группы, которой принадлежит товар. Сведения о доставке и заказчике в объекте заказа перенесены во вложенные объекты delivery и recepient.

VK Donut в 5.125

Добавлены методы:

donut.isDon;

donut.getFriends;

donut.getSubscription;

donut.getSubscriptions.

Информация о VK Donut также появилась в объектах записи и комментария.

Тип магазина в 5.124

В объекте market, который возвращает groups.get, появилось поле type типа string. Оно может принимать значения basic и advanced и возвращается, если в группе включён раздел «Товары».

Изменения загрузки историй

Начиная с версии 5.118 процесс загрузки историй состоит из двух этапов:

1. Вызвать stories.getPhotoUploadServer или stories.getVideoUploadServer и получить uploadresult типа string.

2. Передать полученный uploadresult в stories.save.

В версии 5.115 метод stories.getViewers начал возвращать в items массив объектов с полями isliked и userid.

В версии 5.113 методы stories.get, stories.getReplies и stories.search перешли от массива массивов историй к массиву объектов блоков ленты.

Важные изменения сообщений и Callback API

Версия 5.103

ads.getPostsReach возвращает ошибки отдельно для каждого объявления.

ads.getAdsPostsReach отключён; вместо него используется ads.getPostsReach.

В Callback API и Long Poll API структура messagenew изменена с { object: message } на { object: { message, clientinfo } }.

В clientinfo передаётся информация о клиенте, которую бот может учитывать при формировании сообщения.

Версия 5.102

Сообщения, не помещающиеся в Bots Long Poll API или Callback API, получают отметку iscropped.

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

В stories.getPhotoUploadServer и stories.getVideoUploadServer добавлен clickablestickers.

Версия 5.90

Параметр randomid в messages.send стал обязательным. В этой же версии account.getBanned начал возвращать массивы profiles и groups, а docs.save получил новый формат ответа.

Версия 5.80

В VK API появился новый API сообщений с объектом conversation. Методы messages.getDialogs, messages.getChat, messages.getChatUsers, messages.get и messages.searchDialogs объявлены устаревшими и больше не обновляются.

Также изменены маршруты старых операций:

messages.markAsImportantDialog → messages.markAsImportantConversation;

messages.markAsAnsweredDialog → messages.markAsAnsweredConversation;

messages.deleteDialog → messages.deleteConversation.

Параметр messageids больше не поддерживается в messages.markAsRead.

Устаревшие методы и параметры

При обновлении интеграции особенно важно проверить следующие изменения:

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

с версии 5.100 параметры limit, count и offset в messages.deleteConversation объявлены устаревшими;

с версии 5.86 параметры datefrom и dateto метода stats.get устарели, вместо них применяются timestampfrom и timestampto;

с версии 5.68 устарели groups.getCallbackServerSettings, groups.setCallbackServerSettings и groups.setCallbackServer;

с версии 5.65 устарели audio.getAlbums, audio.addAlbum, audio.editAlbum, audio.deleteAlbum и audio.moveToAlbum;

с версии 5.65 рекламные записи нельзя редактировать через wall.edit: для этого используется wall.editAdsStealth;

в версии 5.10 прекращена поддержка messages.markAsNew.

Изменения типов и форматов, требующие проверки

Несколько обновлений меняли не только набор полей, но и их типы:

в 5.85 поле ts метода groups.getLongPollServer стало иметь тип string, а не integer;

в 5.89 объект пользователя получил обязательные поля isclosed и canaccessclosed;

в 5.87 значения поля wall для сообществ изменились: 2 означает ограниченную стену, 3 — закрытую;

в 5.77 появился новый формат объекта photo;

в 5.76 прекращена поддержка XMLответов;

начиная с 5.56 запросы к api.vk.com выполняются только по HTTPS;

в 5.53 ряд полей сообщества, включая canmessage, canpost и isfavorite, стал возвращаться только при передаче accesstoken.

Реклама и приложения

В версии 5.105 из ответа ads.getStatistics удалено поле goals; вместо него возвращается leadformsends.

Для типа achievement в apps.getActivity появился объект media с изображениями в images. Если изображений нет, поле media отсутствует.

В apps.get добавлены mobilecontrolstype и mobileviewsupporttype, описывающие отображение элементов управления и использование нижней части экрана.

В версии 5.50 в рекламных методах изменены impressionslimit, adplatform и поля дисклеймеров. В частности, disclaimer заменён на disclaimermedical, disclaimerspecialist и disclaimersupplements. Параметры adspecification.adformat в ads.createAds и adformat в ads.getUploadURL стали обязательными.

Ключевые этапы старых версий

VK API 5.0

Версия 5.0 стала крупным обновлением, затронувшим почти все методы API ВКонтакте.

В последующих версиях 5.x последовательно менялись форматы объектов пользователей, сообществ, сообщений, комментариев, фотографий, видео, товаров и рекламных объявлений.

VK API 4.104–4.0

Среди заметных изменений ветки 4.x:

4.104 — добавлен тип вложения photoslist;

4.103 — likes.isLiked начал возвращать объект с полями liked и copied;

4.99 — добавлен audio.setBroadcast;

4.95 — формат комментариев приведён к единообразному виду;

4.94 — ссылки в личных сообщениях стали возвращаться как объект;

4.6 — анонимные опросы получили поле anonymous;

4.2 — chatactive стал массивом вместо строки;

4.0 — count должен быть положительным числом, а offset — неотрицательным.

Что проверить перед сменой версии VK API

1. Форматы ответов. Обратите внимание на методы, для которых прямо указано изменение ответа: например, video.edit, database.getSchoolClasses, groups.getById, wall.getById и docs.save.

2. Переименованные параметры. Проверьте переходы startcmid → uptocmid, guid → randomid и userids → peerids.

3. Обязательные параметры. Среди примеров — randomid в messages.send и lifetime в ads.createTargetGroup и ads.updateTargetGroup.

4. Изменившиеся типы. Не полагайтесь на прежний тип ts в groups.getLongPollServer или старую структуру объектов категорий.

5. Устаревшие методы. Замените методы, помеченные как deprecated, до отключения старой логики.

6. Callback API и Long Poll API. Формат событий зависит от выбранной версии API, поэтому обработчики событий следует тестировать отдельно.

Источник

Полная хронология опубликована в официальном справочнике: версии VK API.

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

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