Июнь 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 кроме отличия в названиях полей ответа в исключительных случаях.
Ознакомиться со структурой ответов в любом методе вы можете на странице конкретного метода. Список всех методов доступен здесь.