Версии

Внимание. Маркет постепенно перестает поддерживать XML. Поэтому мы рекомендуем переходить на JSON. Сейчас XML можно использовать, если добавить в запрос Content-Type: application/xml. Без этого будут ошибки.

На странице описаны версии партнерского API для методов, с помощью которых магазины выполняют запросы к Маркету.

Указание версии в запросе

При запросах к API Маркета магазин должен указывать в URL ресурса версию в формате:

v<основная_версия>

Изменение версии

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

Дополнительная версия обновляется только при добавлении новых ресурсов, возможностей, параметров выдачи и прочих изменениях, при которых приложения, выполняющие запросы к более ранней версии API, работают корректно и на старшей версии. Указывается в описании методов для удобства отслеживания перечисленных изменений в виде v<основная_версия>.<дополнительная_версия>.

Внимание. В запросе указывается номер текущей основной версии. Дополнительная версия в запросе не указывается.

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