Руководство разработчика
Методы API

Версии

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

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

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

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

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

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

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

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

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

Версии