Головна » Версии API
Версії API
5.101
Методы работы со стеной возвращают новый аттач-сниппет для событий с типом events

Обложки в объекте видео теперь передаются в полях image и first_frame в виде массивов объектов video_image.

Обложки в объекте альбома видео теперь передается в поле image в виде массива объектов video_image.

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

Метод wall.edit в случае успеха возвращает post_id — идентификатор отредактированного поста.

Впливає на методи messages.deleteConversation, wall.edit
5.95
В методах wall.getComments, market.getComments, photos.getComments, video.getComments, board.getComments граффити вынесен в отдельный тип attach.

Методы market.add, market.edit принимают параметр url. Объект market теперь может возвращать url и button_title.

5.93
Метод wall.createComment возвращает новую ошибку 222
5.92
Метод wall.getComments возвращает новые поля: comment_id (integer), current_level_count (integer).
Метод wall.createComment возвращает новое поле parents_stack (array).
Добавлен метод wall.getComment.

В объекте комментария к записи на стене возвращаются новые поля parents_stack (array), thread (object). Может возвращаться поле deleted (boolean), говорящее о том, что комментарий был удалён.

В объекте сообщения разделены ответы и пересланные сообщения (reply_message и fwd_messages).

В объектах записи на стене, видеозаписи, товара может возвращаться поле is_favorite (boolean).
5.90
Метод account.getBanned возвращает поля profiles (array) и groups (array) с данными пользователей и сообществ.

Новый формат ответа метода docs.save.

Параметр random_id в методе messages.send обязателен.
Впливає на методи account.getBanned, messages.send, docs.save
5.89
В объекте пользователя добавлены новые обязательные поля:
  • is_closed (boolean) — включена ли приватность профиля;
  • can_access_closed (boolean) — есть ли у текущего пользователя возможность видеть профиль пользователя при is_closed = true.
Впливає на методи users.get, users.search
5.88
Метод messages.removeChatUser возвращает ошибку "935: User not found in chat", если пользователя нет в чате.
Впливає на методи messages.removeChatUser
5.87
В объекте сообщества у поля wall поменялись значения. Для пабликов возвращаются значения:
  • 2 – стена ограничена (было 1);
  • 3 – стена закрытая (было 0).
5.86
Метод messages.search при использовании параметра extended = 1 возвращает массив объектов бесед.

Изменения в методе stats.get:
  • Входные параметры date_from и date_to устарели, вместо них используются timestamp_from и timestamp_to — целые числа, представляющее собой время в Unixtime.
  • Появился входной параметр stats_groups, который позволяет фильтровать по отдельным блокам в статистике. Возможные значения: visitors, reach, activity.
  • В ответе поля period_from и period_to являются целыми числами и так же представляют собой время в Unixtime.
Впливає на методи messages.search, stats.get
5.85
В объекте приложения в поле type приходят новые значения.
  • app — социальное приложение
  • game — игра
  • site — подключенный сайт
  • standalone — отдельное приложение (для мобильного устройства)
  • vk_app — VK App приложение
  • community_app - приложение сообщества
  • html5_game - HTML5 игра

В объекте приложения больше не приходит поле is_html5_app.

Метод messages.getConversationMembers возвращает новую ошибку 917.

Изменения в API опросов:
  • Новый формат объекта опроса.
  • Метод polls.create поддерживает новые параметры для опросов с мультивыбором и фоном.

В методе groups.getLongPollServer изменился тип поля ts — теперь это string, а не integer.
5.84
Метод messages.getChatPreview теперь возвращает максимум 5 участников из чата. Метод messages.getConversationMembers возвращает поле can_kick (boolean) для участников беседы.

В объекте записи на стене для комментариев могут вернуться поля can_close (boolean) и can_open (boolean).
5.83
В объекте сообщения могут приходить вложения с типами graffiti и audio_message. В объекте беседы возвращается поле acl.

5.82
В объекте беседы возвращается новое поле is_group_channel (boolean) для каналов сообществ. Метод stories.get возвращает истории в реверсивном порядке.
Впливає на методи stories.get
5.81
Метод messages.removeChatUser принимает новый параметр member_id (integer). В Callback API и Bots Longpoll добавлено новое событие — платёж через VK Pay.

Метод messages.deleteConversation в ответе возвращает поле last_deleted_id, содержащее идентификатор последнего удалённого сообщения.
Впливає на методи messages.removeChatUser, messages.deleteConversation
5.80
Новый API для сообщений. Изменился объект message, а также появился объект conversation и связанные с ним методы messages.getConversations, messages.getConversationsById, messages.getConversationMembers и messages.searchConversations, messages.getByConversationMessageId.

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

И несколько методов переехало. Старые названия будут перенаправлять на новую версию.
messages.markAsImportantDialogmessages.markAsImportantConversation, messages.markAsAnsweredDialogmessages.markAsAnsweredConversation,
messages.deleteDialogmessages.deleteConversation.

Метод secure.sendSMSNotification отправляет несколько сообщений. Изменился формат ответа.
5.78
Метод groups.getSettings возвращает поле events.
Впливає на методи groups.getSettings
5.77
Новый формат объекта photo.
Впливає на методи photos.get, photos.getAll, photos.getById, photos.save
5.76
Прекращение поддержки ответов в XML формате.
5.75
Новый формат ответа в методе stats.get.

В настройках Callback-сервера и Long Poll API появилась возможность указывать версию API. От нее зависит формат получаемых событий.
Впливає на методи stats.get
5.74
Новый формат стикеров.

Метод с docs.search с параметром search_own перестает возвращать массив local. Вместо этого в items сначала возвращаются документы пользователя, а потом документы из глобального поиска.

Появилась новая ошибка: ошибка 29: Rate limit reached
5.73
В объекте post возвращается поле access_key.
5.71
Метод groups.getBanned возвращает информацию о сообществах из чёрного списка.
Впливає на методи groups.getBanned
5.70
В поле action объекта сообщения может возвращаться значение chat_invite_user_by_link.

В объекте сообщения добавлено поле update_time.

Методы wall.post, wall.editAdsStealth, wall.edit, wall.repost могут возвращать новую ошибку 224 — превышен лимит рекламных записей.

В Callback API добавлено новое событие — message_edit.

5.69
Метод messages.getLongPollHistory возвращает информацию о сообществах в отдельном массиве groups.

Методы newsfeed.search и search.getHints возвращают в ответе поле suggested_queries с подсказками для поиска.

Метод messages.send может вернуть новые ошибки 913 и 921.

Метод friends.getRequests возвращает новое поле count_unread.

Метод search.getHints принимает новый параметр offset.

В объекте пользователя и сообщества может возвращаться дополнительное поле trending («огонёк»).

В поле action объекта сообщения могут возвращаться значения chat_pin_message/chat_unpin_message.

В Callback API добавлены новые события — добавление пользователя в черный список и удаление из него, user_block и user_unblock.
5.68
В объекте записи на стене добавлено поле groups_can_post с информацией о том, могут ли сообщества комментировать запись.
Метод messages.send возвращает массив статусов отправки при использовании параметра user_ids и вызове с ключом доступа сообщества.
Методы groups.getCallbackServerSettings, groups.setCallbackServerSettings и groups.setCallbackServer устарели.
В методах groups.setCallbackSettings, groups.getCallbackSettings добавлен параметр server_id.
5.67
Метод wall.createComment поддерживает идентификатор группы в параметре from_group.

В объекте chat, если массив users пустой, то он не возвращается.
Впливає на методи wall.createComment, messages.getChat
5.66
В методе auth.signup добавлен обязательный параметр birthday.
5.65
Методы audio.getAlbums, audio.addAlbum, audio.editAlbum, audio.addAlbum, audio.deleteAlbum и audio.moveToAlbum устарели.

В методе auth.restore добавлен обязательный параметр last_name.
В методе messages.getLongPollServer добавлен параметр lp_version.
Метод ads.getCategories возвращает результат в новом формате.
Метод wall.edit больше нельзя использовать для редактирования промопоста, вместо него нужно использовать метод wall.editAdsStealth.
Впливає на методи auth.restore, messages.getLongPollServer
5.64
Метод messages.getDialogs возвращает поля unanswered и important для сообщений сообществ.

Метод groups.getCallbackSettings возвращает поле wall_repost, настройка уведомления о репосте.

Метод video.save возвращает ошибку 15, если используется параметр wallpost = 1, и приложение не запрашивало права доступа wall.
Впливає на методи messages.getDialogs, groups.getCallbackSettings, video.save
5.63
В объектах, описывающих запись на стене, добавлено поле views, в котором находится информация о количестве просмотров поста.

Поддержка параметра fields в методах wall.getComments и video.getComments.

Сокращенная ссылка в методе utils.getShortLink возвращается в новом формате с полями:
  • access_key — ключ для доступа к приватной статистике ссылки;
  • key — содержательная часть ссылки (после "vk.cc");
  • url — оригинальный URL.
5.62
Метод messages.getHistoryAttachments возвращает поле message_id для вложений. Добавлено новое значение семейного положения (8 — «в гражданском браке») в объекте пользователя.
5.61
В объекте сообщества возвращается новое поле cover. Метод account.getCounters принимает в параметре filter новое значение friends_suggestions. В методе pages.get добавлена проверка на наличие прав администратора для использования параметра need_source.
Впливає на методи account.getCounters, groups.get, groups.getById, pages.get
5.60
Метод account.getInfo возвращает дополнительное поле 2fa_required для аккаунтов с включенной 2FA. В методе photos.get добавлено ограничение на параметр feed (не более месяца с текущей даты).

Для вложений с типом link поле button возвращается с новой структурой: link_button.
Впливає на методи wall.getById, wall.get, newsfeed.get, account.getInfo, photos.get
5.59
Обновлены требования к размерам изображений в рекламных объявлениях. Подробнее см. на этой странице.
Впливає на методи ads.createAds, ads.getUploadURL, ads.updateAds
5.58
В объектах, описывающих сообщество, добавлено поле is_messages_blocked.

В Callback API добавлены два новых события — message_allow и message_deny. Метод groups.setCallbackSettings принимает два новых параметра, а метод groups.getCallbackSettings возвращает два новых поля, соответственно.
5.57
В объекте приложения изменились названия полей и размеры изображений иконок и баннеров.
Впливає на методи apps.get, apps.getCatalog
5.56
HTTPS-only. Делать запросы к api.vk.com с этой версии можно только по протоколу https.
5.54
В объектах, описывающих сообщество, поле finish_date не возвращается, если дата окончания не задана (ранее возвращалось значение по умолчанию, равное start_date + 2 часа).
5.53
В объектах, описывающих сообщество, поля can_message, ban_info, can_post, can_upload_doc, can_upload_video, can_see_all_posts, can_create_topic, is_favorite, is_hidden_from_feed возвращаются только для запросов с передачей access_token.
5.52
В медиавложениях сообщений и записей возвращаются объекты с типами market и market_album.
5.50
В методе ads.getAds: возвращаемое поле impressions_limit было разделено на два поля: impressions_limit и impressions_limited, изменено возвращаемое поле ad_platform, убрано возвращаемое поле disclaimer, добавлены поля disclaimer_medical, disclaimer_specialist, disclaimer_supplements.
В методах ads.createAds и ads.updateAds: параметр impressions_limit в ad_specification был разделён на два параметра: impressions_limit и impressions_limited, изменён параметр ad_platform из ad_specification, убран параметр disclaimer из ad_specification, добавлены параметры disclaimer_medical, disclaimer_specialist, disclaimer_supplements в ad_specification.
В методе ads.createAds: параметр ad_format в ad_specification стал обязательным.
В методе ads.getUploadURL: параметр ad_format стал обязательным.
Впливає на методи ads.getAds, ads.createAds, ads.updateAds, ads.getUploadURL
5.49
Метод account.setInfo принимает универсальные параметры name и value вместо раздельных параметров.
Впливає на методи account.setInfo
5.48
В методе messages.getHistory можно передавать параметр rev вместе с start_message_id и start_message_id равный 0. Метод friends.edit возвращает ошибку Code: 100, Message: invalid list_ids если указан неправильный list_ids.
Впливає на методи messages.getHistory, friends.edit
5.46
Методы messages.send и messages.sendSticker принимают параметр random_id вместо guid. Метод account.getPushSettings возвращает поле peer_id вместо chat_id и user_id. Метод account.setSilenceMode принимает параметр peer_id вместо chat_id и user_id. Метод messages.getHistoryAttachments возвращает товары, записи со стены и комментарии в виде ссылок.
5.45
Для медиавложений в сообщениях с типом link возвращаются поля caption, is_external, product, application, rating и button.
5.44
Методы docs.get, docs.getById возвращают поле preview вместо полей photo_100, photo_130. Метод messages.searchDialogs возвращает сообщества в результате поиска.
Впливає на методи docs.get, docs.getById, messages.searchDialogs
5.43
Параметры out, time_offset, filters в методе messages.get могут быть только положительными.
Параметр message_ids стал обязательным в методе messages.getById.
Впливає на методи messages.get, messages.getById
5.42
Метод gifts.get может вернуть отрицательный from_id. Метод notifications.get возвращает уведомления об упоминаниях в описаниях фотографий.
Впливає на методи gifts.get, notifications.get
5.41
Метод notifications.get возвращает уведомления о новых ответах к комментариям в товарах. Метод newsfeed.getComments возвращает комментарии к товарам. Методы wall.get, wall.search, wall.getById возвращают market_album в медиа-вложениях.
5.40
Добавлена поддержка параметра fields для профилей
Впливає на методи newsfeed.get, wall.getById, wall.get, wall.search
5.39
Для медиавложений с типом link возвращаются поля caption, is_external, product, application, rating и button.
Впливає на методи wall.get, wall.search, wall.getById, wall.getComments
5.38
Методы apps.get и apps.getCatalog возвращают объект photo для полей screenshots. Добавлены поля in_read, out_read в ответы методов messages.getDialogs и messages.getHistory.
Добавлен параметр peer_id для методов messages.send, messages.sendSticker, messages.deleteDialog, messages.setActivity и messages.getHistory.
5.37
Для медиавложений с типом link вместо полей image_src и image_big возвращается объект photo.
Впливає на методи wall.get, wall.search, wall.getById, wall.getComments
5.36
Добавлены параметры app_ids, return_friends. Добавлены поля installed, screenshots.
Впливає на методи apps.get
5.35
Добавлены методы для работы с активностями приложений.
5.34
Если доступ к комментариям видео ограничен, при запросе комментариев вернется ошибка.
Впливає на методи video.getComments
5.33
Добавлен параметр start_comment_id для получения комментариев, начиная с указанного.
5.32
В объекте приватности добавлено возможное значение friends_of_friends_only.
5.31
Параметр device_id является обязательным. Изменен формат настроек приватности.
5.29
messages.getLongPollHistory поддерживает поле fields.
Впливає на методи messages.getLongPollHistory
5.28
Новый формат результата метода friends.delete
Впливає на методи friends.delete
5.27
Переход на параметры start_from, next_from в методе notifications.get
Впливає на методи notifications.get
5.26
newsfeed.getSuggestedSources возвращает результат в виде списка
Впливає на методи newsfeed.getSuggestedSources
5.25
Возвращаются более корректные ошибки в методе apps.sendRequest
Впливає на методи apps.sendRequest
5.24
Добавлен тип wall_publish, который означает, что предложенный пост пользователя размещен.
Впливає на методи notifications.get
5.23
При передаче параметра photo_sizes в методе photos.saveOwnerPhoto будут возвращены все размеры фотографии.

Изменен параметр метода newsfeed.getComments: теперь можно ограничить количество комментариев к записям.

В метод groups.getMembers добавлена возможность получать возможных участников события.
5.22
Убрано ошибочное разделение параметра schools на два, теперь снова используется один параметр schools. Список ID для этого параметра следует получать в методе ads.getSuggestions.
5.21
Поле uid в ответе метода video.getTags заменено на user_id.
Впливає на методи video.getTags
5.20
Вики-страница вложенная в пост теперь приходит в виде объекта вики-страницы.
В методе pages.get был добавлен параметр need_source, поле source теперь по умолчанию не возвращается.
5.19
В объекте группа поля start_date и finish_date стали числами вместо строк.
При установленном фильтре friend для новостей возвращается user_id вместо uid.
В методе fave.getLinks изображения возвращаются с именами photo_50 и photo_100 вместо image_src и image_middle.
5.18
Заменены возвращаемые переменные: reply_to_uid на reply_to_user, reply_to_cid на reply_to_comment.
Впливає на методи widgets.getComments, notifications.get
5.17
Новые типы упоминаний в notifications.get: mention_comment_photo и mention_comment_video.
Впливає на методи notifications.get
5.16
Параметр schools разделён на два: schools и universities. Теперь id этих объектов такие же, как и в методах database.
5.15
В методе newsfeed.search появился параметр extended, при передаче которого возвращаются полные результаты со всеми необходимыми для вывода данными о группах или пользователях.
В методе friends.areFriends изменён алгоритм генерации поля sign, в нём теперь есть id пользователя.
В методах newsfeed.get и newsfeed.getRecommeded исправлено представление объектов note, теперь возвращается id и comments.
5.14
В методе messages.getDialogs появился параметр unread, при передаче которого возвращаются только диалоги с непрочитанными входящими сообщениями, а в результат добавлено количество таких диалогов unread_dialogs (если больше нуля) и в каждом диалоге возвращается количество непрочитанных входящих unread (если больше нуля).

В методе messages.getHistory параметр rev недоступен при передаче start_message_id, поведение start_message_id и его связь с offset изменены, в результат добавлено количество непрочитанных входящих в диалоге unread (если больше нуля) и количество пропущенных сообщений skipped при использовании start_message_id (если оно больше нуля).
Впливає на методи messages.getDialogs, messages.getHistory
5.13
Новый параметр для пагинации: start_from, приходящий в виде строки в поле next_from для получения следующей страницы.
5.12
Новые типы ошибок в методах audio.get, video.get.
Новый параметр для пагинации: start_from, приходящий в виде строки в поле next_from для получения следующей страницы.
5.11
В случае успешной смены имени также возвращается поле name_request co значением status равным success.
Впливає на методи account.saveProfileInfo
5.10
В методе messages.get для параметра filter разрешены только значения 0 (все входящие или все исходящие сообщения, по полю out) или 8 (важные сообщения), остальные значения игнорируются.
Метод messages.markAsNew больше не поддерживается.
Впливає на методи messages.get, messages.markAsNew
5.9
Изменение поля cid на id в newsfeed.getComments.
в notifications.get объект video в новом формате.
friends.getLists список теперь возвращается в виде объекта с полем count, list_id заменен на id.
board.getTopics опросы приходят в новом формате.
audio.getAlbums и video.getAlbumsid вместо album_id.
audio.getRecommendations, friends.getSuggestions – возвращается в форме списка.
groups.getMembers – результат в виде списка.
places.getCheckinsuser_id вместо uid в объектах отметок.
5.8
Поля city и country в fields возвращают объект вместо идентификатора.
Впливає на методи users.get, users.search, friends.get
5.7
Новый формат записей:
to_id вместо owner_id
reply_post_id вместо reply_to в copy_history
Впливає на методи wall.get, wall.getById, newsfeed.get
5.6
Поле post_type возвращает post вместо copy для репостов.
Впливає на методи wall.get, wall.getById, newsfeed.get
5.5
Для группируемых оповещений (пользователи оценили, поделились, подписались, ..) в поле feedback кроме идентификаторов последних пользователей, совершивших действие, возвращается полное количество пользователей, совершивших это действие за последние сутки.
Впливає на методи notifications.get
5.4
Во всех методах, которые возвращают объекты пользователей в profiles, поля photo, photo_medium_rec у пользователей переименованы в photo_50, photo_100.
Во вложении wall в сообщениях поля from и copy_owner возвращают объект пользователя или сообщества, вместо массива.
5.3
Поле id вместо pid, новый формат полей edited и created
Впливає на методи pages.get
5.2
В объекте feedback: owner_id был заменен на from_id, исправлен баг со строкой в owner_id.
Впливає на методи notifications.get
5.1
Исправлен тип прикрепления photos_list. (было photo_list). Другие исправления, забытые в версии 5.0
video.getUserVideos - поля photo_160, photo_320
photos.getTags - убраны устаревшие поля uid, tag_id
notifications.get - у тем tid заменен на id
5.0
Глобальное обновление API, затрагивающее почти все методы. Посмотреть список изменений
Впливає на методи wall.get
4.104
Новый формат прикрепления photos_list.
Впливає на методи wall.get, wall.getById, newsfeed.get, newsfeed.getComments
4.103
Новый формат ответа, объект с полями liked и copied.
Впливає на методи likes.isLiked
4.102
Новый формат репостов. Поддержка репостов от репостов.
Впливає на методи wall.get, wall.getById
4.101
При прикреплении альбома в тексте записи не будет передаваться ссылка на альбом.
Впливає на методи wall.get, wall.getById, newsfeed.get, newsfeed.getComments
4.100
При получении сообщения о смене или удалении фотографии в мультидиалоге больше не приходит пояснение действия в тексте сообщения.
Впливає на методи messages.get, messages.getHistory
4.99
Позволяет транслировать аудиозапись в статус пользователя или любой из администрируемых групп.
4.98
Возвращает количество результатов первым элементом ответа
Впливає на методи photos.getAlbums
4.97
Были удалены поля online и reply_count
Впливає на методи wall.get
4.96
Возвращает количество результатов первым элементом ответа
Впливає на методи video.search
4.95
Изменен формат комментариев, все методы теперь возвращают их в единообразной форме
4.94
Изменен формат ссылок, прикрепленных к личным сообщениями, теперь они возвращаются как отдельные объекты
4.93
Изменено название поля users на items, а uid на item
Впливає на методи likes.getList
4.92
Возвращает количество результатов первым элементом ответа
4.91
Изменено значение возвращаемого поля uid, теперь это отправитель сообщения.
Впливає на методи messages.getHistory
4.9
Изменен формат возвращения мест, начиная с этой версии не будут возвращаться поля, оставленные для совместимости
4.8
Возвращает подарки отдельным объектом, а не в виде документов
4.7
Изменяет вид возвращаемых комментариев, делая их структуру аналогичной комментариям в других методах
Впливає на методи notifications.get
4.6
Помечает анонимные опросы отдельным полем anonymous, не добавляя информации к заголовкам публичных опросов.
Впливає на методи polls.getById
4.5
Возвращает количество результатов первым элементом ответа
Впливає на методи subscriptions.get, subscriptions.getFollowers
4.4
Возвращает прикрепления в комментариях
Впливає на методи newsfeed.getComments, wall.getComments
4.3
Возвращает результат в виде объекта, содержащего профили и группы, необходимые для отображения найденных записей
Впливає на методи newsfeed.search
4.2
Поле chat_active возвращается в виде массива, а не строки.
4.1
Возвращает количество результатов первым элементом ответа.
Впливає на методи photos.get
4.0
offset и count могут быть только положительными
Впливає на методи messages.get, messages.getDialogs