Июнь 2021. Отказ от формата XML в REST API

Просим обратить внимание, что в связи с завершением поддержки формата XML при работе с OK API всем разработчикам, которые всё еще используют XML при работе с API, рекомендуется перейти на использование формата JSON.

Дата завершения поддержки формата XML - 1 сентября 2021 года.

Почему мы отказываемся от этого формата

На протяжении всего времени существования OK API было доступно два формата взаимодействия клиентских приложений с нашим API:

  • JSON - основной формат, используемый в 99.9% запросов;
  • XML - дополнительный формат, используемый крайне редко.

Поэтому по причине непопулярности и нецелесообразности поддержки этого формата данных было принято решение не продолжать его поддержку и отказаться от него.

Почему надо перейти на новый формат

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

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

Каждый метод, который вы вызывали с использованием формата XML будет работать только с форматом JSON после завершения поддержки XML.

Переход с XML на JSON

Для миграции с формата XML на формат JSON вам потребуется:

  • при запросах к API указывать параметр format = json;
  • обрабатывать ответ в новом формате.

Структура ответов любого метода в формате JSON ничем не отличается от формата XML кроме отличия в названиях полей ответа в исключительных случаях.

Ознакомиться со структурой ответов в любом методе вы можете на странице конкретного метода. Список всех методов доступен здесь.