Версии API

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

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

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

v<мажорная_версия>.<минорная_версия>.<версия_патча>

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

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

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

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

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

  • v2.1.0:Новая версия API
  • v2.1.1:Новая версия API
  • v2.1.2:Новая версия API
    1. Для изображении модели и товарного предложения стали отдавать их уменьшенные копии.
    2. У товарного предложения перестали отдавать previewPhotos.
  • v2.1.3:Новая версия АПИ
    1. Начиная с этой версии можно применять поле ru.yandex.market.api.domain.v2.FilterField#STATISTICS в ручке v2/cateogries/{id}/filters. При неуказании полей ru.yandex.market.api.domain.v2.FilterField#STATISTICS и ru.yandex.market.api.domain.v2.FilterField#SORTS ручка будет отвечать значительно быстрее
Псевдонимы значений:
  • v2.1 = v2.1.3
  • v2 = v2.1.3