Модель

Информация о модели

Структура выходных данных приведена ниже. Порядок следования параметров не гарантируется.

{
  "id" : {int64},
  "name" : "{string}",
  "kind" : "{string}",
  "type" : "{enum}",
  "parent" : {
    "id" : {int64}
  },
  "isNew" : {boolean},
  "description" : "{string}",
  "photo" : {
    "width" : {int32},
    "height" : {int32},
    "url" : "{string}",
    "colorId" : "{string}",
    "thumbnails" : [
      {
        "width" : {int32},
        "height" : {int32},
        "url" : "{string}",
        "container" : "{enum}"
      },
      ...
    ],
    "criteria" : [
      {
        "id" : "{string}",
        "value" : "{string}"
      },
      {
        "id" : "{string}",
        "value" : "{string}",
        "text" : "{string}"
      },
      ...
    ]
  },
  "photos" : [
    {
      "width" : {int32},
      "height" : {int32},
      "url" : "{string}",
      "colorId" : "{string}",
      "thumbnails" : [
        {
          "width" : {int32},
          "height" : {int32},
          "url" : "{string}",
          "container" : "{enum}"
        },
        ...
      ],
      "criteria" : [
        {
          "id" : "{string}",
          "value" : "{string}"
        },
        {
          "id" : "{string}",
          "value" : "{string}",
          "text" : "{string}"
        },
        ...
      ]
    },
    ...
  ],
  "category" : {
    Содержимое объекта
  },
  "navigationNode" : {
    Содержимое объекта
  },
  "price" : {
    "max" : "{string}",
    "min" : "{string}",
    "avg" : "{string}",
    "discount" : "{string}",
    "base" : "{string}"
  },
  "alternatePrice" : {
    "max" : "{string}",
    "min" : "{string}",
    "avg" : "{string}",
    "discount" : "{string}",
    "base" : "{string}"
  },
  "vendor" : {
    Содержимое объекта
  },
  "rating" : {
    "value" : {float},
    "count" : {int32},
    "distribution" : [
      {
        "value" : {float},
        "count" : {int64},
        "percent" : {int32}
      },
      ...
    ]
  },
  "facts" : {
    "pro" : [
      "{string}",
      ...
    ],
    "contra" : [
      "{string}",
      ...
    ]
  },
  "warning" : "{string}",
  "warnings" : [
    {
      "code" : "{string}",
      "message" : "{string}"
    },
    ...
  ],
  "filters" : [
    {
      "id" : "{string}",
      "name" : "{string}",
      "type" : "{string}",
      "description" : "{string}"
    },
    {
      "id" : "{string}",
      "name" : "{string}",
      "type" : "{string}",
      "unit" : "{string}",
      "defaultUnit" : "{string}",
      "description" : "{string}",
      "values" : [
        {
          "id" : "{string}",
          "name" : "{string}",
          "initialFound" : {int64},
          "found" : {int64},
          "checked" : {boolean}
        },
        {
          "id" : "{string}",
          "name" : "{string}",
          "initialFound" : {int64},
          "found" : {int64},
          "checked" : {boolean},
          "color" : "{string}"
        },
        {
          "id" : "{string}",
          "name" : "{string}",
          "initialFound" : {int64},
          "found" : {int64},
          "checked" : {boolean},
          "unitId" : "{string}"
        },
        {
          "id" : "{string}",
          "name" : "{string}",
          "initialFound" : {int64},
          "found" : {int64},
          "checked" : {boolean},
          "color" : "{string}",
          "photo" : "{string}"
        },
        ...
      ]
    },
    {
      "id" : "{string}",
      "name" : "{string}",
      "type" : "{string}",
      "unit" : "{string}",
      "description" : "{string}",
      "max" : "{string}",
      "min" : "{string}",
      "value" : "{string}",
      "precision" : {int32}
    },
    ...
  ],
  "link" : "{string}",
  "offerCount" : {int64},
  "opinionCount" : {int32},
  "reviewCount" : {int32},
  "modificationCount" : {int32},
  "lastUpdate" : {int64},
  "userRelated" : {
    "inComparisonList" : {boolean},
    "inWishlist" : {boolean}
  },
  "modifications" : [
    {
      Содержимое объекта
    },
    ...
  ],
  "specification" : [
    {
      "name" : "{string}",
      "features" : [
        {
          "name" : "{string}",
          "value" : "{string}"
        },
        ...
      ]
    },
    ...
  ]
}

Описание параметров:

Параметр для формата JSON Параметр для формата XML Тип Описание
id id

Int64

Идентификатор модели.

name name

String

Наименование модели

kind kind

String

Тип товара

type type

Enum

Тип модели

Возможные значения:
  • MODEL — Обычная модель

  • GROUP — Групповая модель

  • MODIFICATION — Модификация

  • BOOK — Книга

  • CLUSTER — Визуальная модель

isNew isNew

Boolean

Признак "новизны" товара

link link

String

Ссылка на карточку модели на большом маркете

offerCount offerCount

Int64

Кол-во товарных предложений модели в регионе запроса

opinionCount opinionCount

Int32

Кол-во отзывов на модель

reviewCount reviewCount

Int32

Кол-во статей/обзоров на модель

modificationCount modificationCount

Int32

Кол-во модификаций групповой модели. Поле отсутствует в выдаче, если модель не групповая

lastUpdate lastUpdate

Int64

Дата-время последнего обновления модели в спсике стравнения
Примечание. Только для списков сравнения
parent parent

Object

Информация о групповой модели к которой относится модификация.
Ограничение. Заполняется только у модифкаций.
description description

String

Описание модели

photo photo

Object

Основное изображение модели

photos photos

Object list

Остальные изображения модели

category category

Object

Информация о категории, к которой относится модель

Категория

navigationNode navigationNode

Object

Информация об узле навигационного дерева, к которому относится модель

Навигационная категория

price price

Object

Информация о цене модели в основной валюте запроса

alternatePrice alternatePrice

Object

Информация о цене модели в альтернативной валюте запроса

vendor vendor

Object

Информация о производителе модели

Производитель

rating rating

Object

Информация о рейтинге модели

facts facts

Object

Факты о модели

warning warning

String

Дисклеймер, связанный с моделью.

Только в версиях API: 2.1.0-2.1.1.

warnings warnings

Object list

Строковый код дисклеймера

Только в версиях API: 2.1.1+.

filters filters

Object list

Список фильтров, предназначенных для фильтрации моделей/модификаций

Типы:
  • Фильтр.
  • Фильтр со значениями.
  • Числовой фильтр
modifications modifications

Object list

Список модификаций групповой модели. Получаются с fields=MODIFICATIONS

Модификация

specification specification

Object list

Основные характеристики модели

userRelated userRelated

Object

Информация, касающаяся текущего пользователя

model-v2-model-id Параметры, вложенные в parent
id id

Int64

Идентификатор модели.

image-with-thumbnails Параметры, вложенные в photo, photos
width width

Int32

Ширина изображения

height height

Int32

Высота изображения

url url

String

Ссылка на изображение

colorId colorId

String

Код значения фильтра по цвету.
Примечание. Имеет значение только для моделей у которых есть фильтр по цвету
thumbnails thumbnails

Object list

Уменьшенные копии изображения

Только в версиях API: 2.1.2+.

criteria criteria

Object list

Типы:
  • Критерий фильтрации
  • Критерий фильтрации по поисковой фразе
thumbnail Параметры, вложенные в photo/thumbnails, photos/thumbnails
width width

Int32

Ширина изображения

height height

Int32

Высота изображения

url url

String

Ссылка на изображение

container container

Enum

Размер контейнера для которого подготовлена уменьшенная копия изображения

Возможные значения:
  • W50xH50 — 50x50

  • W100xH100 — 100x100

  • W150xH150 — 150x150

  • W200xH200 — 200x200

  • W300xH300 — 300x300

criterion,text-criterion Параметры, вложенные в photo/criteria, photos/criteria Типы: Критерий фильтрации, Критерий фильтрации по поисковой фразе
id id

String

Идентификатор фильтра.

value value

String

Значение фильтра

text text

String

Текст поисковой фразы

model-price-v2 Параметры, вложенные в price, alternatePrice
max max

String

Максимальная цена

min min

String

Минимальная цена

avg avg

String

Среднее значение цены

discount discount

String

Скидка

base base

String

Базовое значение цены

rating-v2 Параметры, вложенные в rating
value value

Float

Средняя оценка рейтинга

count count

Int32

Кол-во оценок

distribution distribution

Object list

Информация о распределении оценок

review-rating-distribution-item Параметры, вложенные в rating/distribution
value value

Float

Значение оценки

count count

Int64

Кол-во оценок с указанным значением

percent percent

Int32

Доля оценок с указанным значением среди всех оценок

model-facts-v3 Параметры, вложенные в facts
pro pro

String list

Достоинства

contra contra

String list

Недостатки

warning-info Параметры, вложенные в warnings
code code

String

Строковый код дисклеймера

message message

String

Текст дисклеймера

filter,numeric-filter,enum-filter Параметры, вложенные в filters Типы: Фильтр., Фильтр со значениями., Числовой фильтр
id id

String

Идентификатор фильтра.

name name

String

Наименование фильтра.

type type

String

Тип фильтра.

Возможные значения:
  • BOOLEAN — логический тип.
  • NUMBER — числовой тип, задает диапазон допустимых значений.
  • ENUM — тип перечисление, задает список допустимых значений, множественный выбор.
  • COLOR — фильтр по цвету, аналогичен ENUM, значения фильтра дополнительно содержат HEX-код соответствующего цвета.
  • SIZE — фильтр по размеру, аналогичен ENUM, значения фильтра дополнительно содержат код единиц измерения.
  • RADIO — аналогичен ENUM, но допускает выбор только одного значения.
  • TEXT — тип фильтра для фильтрации по поисковой фразе.
description description

String

Описание фильтра.

unit unit

String

Единицы измерения значений фильтра.

defaultUnit defaultUnit

String

Код единиц измерения значений фильтра, используемых по умолчанию.

values values

Object list

Список значений фильтра

Типы:
  • Значение фильтра
  • Значение COLOR фильтра
  • Значение SIZE фильтра
  • Значение Filters.FilterType#PHOTO_PICKER фильтра
max max

String

Максимальное значение числового фильтра

min min

String

Минимальное значение числового фильтра

value value

String

Выбранное значение числового фильтра

precision precision

Int32

Кол-во знаков поле запятой у значений фильтра

photo-picker-enum-value,filter-value,size-enum-value,color-enum-value Параметры, вложенные в filters/values Типы: Значение фильтра, Значение COLOR фильтра, Значение SIZE фильтра, Значение Filters.FilterType#PHOTO_PICKER фильтра
id id

String

Идентификатор значения фильтра, используется для установки значения фильтра

name name

String

Текстовое описание значение фильтра

initialFound initialFound

Int64

Кол-во моделей/офферов в выдаче, попадающих под значение фильтра, при отсутствии других фильтров

found found

Int64

Кол-во моделей/офферов в выдаче, попадающих под значение фильтра, при текущих условиях фильтрации

checked checked

Boolean

Признак того, что значение выбрано в соответствии с текущими условиями фильтрации

color color

String

Значение цвета
Внимание. Только для фильтров типов COLOR и Filters.FilterType#PHOTO_PICKER
unitId unitId

String

Код единицы измерения размера значения фильтра
Внимание. Только для фильтра типа SIZE
photo photo

String

Ссылку на картинку для выбора цвета
Внимание. Только для фильтра типа Filters.FilterType#PHOTO_PICKER
specification-group Параметры, вложенные в specification
name name

String

Название группы характеристик

features feature

Object list

Список характеристик

specification-group-feature Параметры, вложенные в specification/features(feature)
name name

String

Наименование характеристики

value value

String

Значение характеристики

model-v2-user-related Параметры, вложенные в userRelated
inComparisonList inComparisonList

Boolean

Модель находится в списках сравнений

inWishlist inWishlist

Boolean

Модель находится в отложеннных