VK API 5.199: что изменилось и что проверить разработчикам

Главное

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

Для перехода на 5.199 адаптировать интеграции изза публичных изменений API не требуется. Однако разработчикам, использующим более ранние версии, стоит проверить предыдущие обновления: среди них есть изменения форматов ответа, переименования параметров и устаревшие методы.

Что изменилось в VK API 5.199

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

Не изменились:

состав методов VK API;

параметры методов;

форматы возвращаемых значений.

Это означает, что в публичном контракте API для версии 5.199 изменений не заявлено.

Последние изменения перед версией 5.199

VK API 5.195

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

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.x

Сообщения

В версии 5.154 в messages. появился тип вложения narrative.

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

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

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

В той же версии переходы определены так: messages.markAsImportantDialog → messages.markAsImportantConversation, messages.markAsAnsweredDialog → messages.markAsAnsweredConversation, messages.deleteDialog → messages.deleteConversation.

Товары и заказы

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

В market.getById поле category получило необязательное рекурсивное поле parent вместо обязательного section.

В версии 5.131 методы market.add и market.edit, а также товарные объекты в market.getOrderItems, market.getOrderById и market.get получили поле sku.

В версии 5.130 в market.editOrder добавлены deliveryprice, tracknumber, paymentstatus, width, length, height и weight.

В версии 5.120 в объекте товара появился объект dimensions.

Истории

С версии 5.118 методы stories.getPhotoUploadServer и stories.getVideoUploadServer возвращают uploadresult. Для завершения загрузки требуется вызвать stories.save, передав этот результат.

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

В версии 5.113 изменён формат ленты в stories.get, stories.getReplies и stories.search.

Callback API и Long Poll API

В версии 5.103 событие messagenew изменилось с { object: message } на { object: { message, clientinfo } }.

В версии 5.75 в настройках Callbackсервера и Long Poll API появилась возможность указывать версию API, от которой зависит формат событий.

В версии 5.85 тип поля ts в ответе groups.getLongPollServer изменён с integer на string.

Общие требования

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

С версии 5.56 запросы к api.vk.com разрешены только по HTTPS.

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

Что проверить разработчикам

Если интеграция уже работает на версии 5.199, отдельная миграция изза этого обновления не заявлена. При переходе со старой версии полезно проверить:

1. Форматы ответов video.edit, database.getSchoolClasses, groups.getById, market.getCategories и wall.getById.

2. Использование uptocmid вместо startcmid в messages.markAsRead.

3. Переход с userids на peerids в messages.send.

4. Наличие обязательного randomid при отправке сообщений.

5. Обработку структуры { object: { message, clientinfo } } для события messagenew.

6. Тип string для поля ts в groups.getLongPollServer.

7. Отказ от устаревших методов сообщений и XMLответов.

8. Выполнение запросов к api.vk.com только по HTTPS.

Источник

Полная история изменений доступна в официальной документации: версии VK API.

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

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