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

Версии API

На странице описаны правила указания версии контентного API.

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

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

Указана полная версия
v<мажорная_версия>.<минорная_версия>.<версия_патча>
Указаны мажорная и минорная версии
v<мажорная_версия>.<минорная_версия>

При таком указании версии произойдет автоматическое обращение к версии последнего патча (в рамках указанной минорной версии). Например, при указании v2.0 произойдет обращение к версии v2.0.10.

Указана только мажорная версия
v<мажорная_версия>

При таком указании версии произойдет автоматическое обращение к версии последнего патча последней минорной версии (в рамках указанной мажорной версии). Например, при указании v2 произойдет обращение к  версии v2.1.0.

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

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

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

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

Список версий

  • v2.1.0:Новая версия API

Псевдонимы значений:

  • v2.1 = v2.1.0
  • v2 = v2.1.0

Версии Версии API