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

Информация о категории

Описание

GET /{version}/categories/{id}

Возвращает информацию об указанной категории по ее идентификатору.

URL ресурса:

https://api.content.market.yandex.ru/{version}/categories/{id}

Входные данные

ПараметрПоложе­ниеТипОбяза­тельностьОписание
version PATH Enum Да

Версия API.

id PATH Int32 Да

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

fields QUERY Enum list Нет

Параметры категории, которые необходимо показать в выходных данных.

Возможные значения:

  • PARENT — информация о родительской категории.
  • STATISTICS — статистика по категории. Например, количество моделей и товарных предложений в категории.
  • WARNINGS — предупреждения, связанные с показом категории.

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

  • ALL = Все значения
    Примечание. Значение ALL доступно только для отладки и имеет ограничение по нагрузке – один RPS.

format QUERY Enum Нет

Формат выходных данных.

Возможные значения:

  • JSON — выходные данные будут сформированы в формате JSON.
  • XML — выходные данные будут сформированы в формате XML.

Значение по умолчанию: JSON .

Выходные данные

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

{
  "status
[no-highlight[

Статус обработки запроса.

Возможные значения:

  • OK — операция выполнена успешно.

  • ERROR — произошла ошибка.

]no-highlight]
" : "{enum}", "context
[no-highlight[

Контекст обработки запроса.

]no-highlight]
" : { "region
[no-highlight[

Информация о регионе запроса.

]no-highlight]
" : { "id
[no-highlight[

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

]no-highlight]
" : {int32}, "name
[no-highlight[

Наименование региона.

]no-highlight]
" : "{string}", "type
[no-highlight[

Тип региона.

Возможные значения:

  • CONTINENT — континент.

  • REGION — регион.

  • COUNTRY — страна.

  • COUNTRY_DISTRICT — федеральный округ.

  • SUBJECT_FEDERATION — субъект федерации.

  • CITY — город.

  • VILLAGE — село.

  • CITY_DISTRICT — район города.

  • METRO_STATION — станиция метро.

  • SUBJECT_FEDERATION_DISTRICT — район субъекта федерации.

  • AIRPORT — аэропорт.

  • OVERSEAS_TERRITORY — отдельная территория какого-либо государства, расположенная в другой части света (например, Ангилья, Гренландия, Бермудские острова и т. д.).

  • SECONDARY_DISTRICT — район города второго уровня (например, для ВАО Москвы районами второго уровня являются Измайлово, Новокосино, Перово и т. д.).

  • MONORAIL_STATION — станция монорельса.

  • RURAL_SETTLEMENT — сельское поселение.

  • OTHER — другой тип населенного пункта.

]no-highlight]
" : "{enum}", "childCount
[no-highlight[

Количество дочерних регионов.

]no-highlight]
" : {int32}, "country
[no-highlight[

Страна, к которой относится регион.

Регион

]no-highlight]
" : { Содержимое объекта } }, "currency
[no-highlight[

Валюта запроса.

]no-highlight]
" : { "id
[no-highlight[

Код валюты.

]no-highlight]
" : "{string}", "name
[no-highlight[

Название валюты.

]no-highlight]
" : "{string}" }, "alternateCurrency
[no-highlight[

Альтернативная валюта запроса.

]no-highlight]
" : { "id
[no-highlight[

Код валюты.

]no-highlight]
" : "{string}", "name
[no-highlight[

Название валюты.

]no-highlight]
" : "{string}" }, "warnings
[no-highlight[

Список предупреждений, возникших при обработке запроса.

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

]no-highlight]
" : [ { "type
[no-highlight[

Тип предупрежедния.

]no-highlight]
" : "{string}", "code
[no-highlight[

Код предупреждения.

]no-highlight]
" : "{string}", "message
[no-highlight[

Сообщение с описанием предупреждения.

]no-highlight]
" : "{string}" }, ... ], "id
[no-highlight[

Уникальный идентификатор запроса.

]no-highlight]
" : "{string}", "time
[no-highlight[

Дата и время выполнения запроса в формате ISO 8601.

]no-highlight]
" : "{date}", "marketUrl
[no-highlight[

Ссылка на Яндекс.Маркет.

]no-highlight]
" : "{string}" }, "category
[no-highlight[

Информация о категории.

]no-highlight]
" : { "id
[no-highlight[

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

]no-highlight]
" : {int32}, "name
[no-highlight[

Наименование категории.

]no-highlight]
" : "{string}", "fullName
[no-highlight[

Полное наименование категории.

]no-highlight]
" : "{string}", "parent
[no-highlight[

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

]no-highlight]
" : {int32}, "adult
[no-highlight[

Признак категории, имеющей возрастное ограничение (18+).

]no-highlight]
" : {boolean}, "link
[no-highlight[

Ссылка на карточку категории на Яндекс.Маркете.

]no-highlight]
" : "{string}", "childCount
[no-highlight[

Количество дочерних категорий.

]no-highlight]
" : {int32}, "modelCount
[no-highlight[

Количество моделей в категории.

]no-highlight]
" : {int32}, "offerCount
[no-highlight[

Количество товарных предложений в категории.

]no-highlight]
" : {int32}, "advertisingModel
[no-highlight[

Тип размещения товарных предложений в категории.

Возможные значения:

  • CPA — плата за заказы, оформленные прямо на Яндекс.Маркете.

  • CPC — плата только за клики по предложению магазина.

  • HYBRID — возможны оба варианта размещения товарных предложений в категории.

]no-highlight]
" : "{enum}", "viewType
[no-highlight[

Тип отображения товаров в категории.

Возможные значения:

  • LIST — список.

  • GRID — сетка.

]no-highlight]
" : "{enum}", "warnings
[no-highlight[

Предупреждения, связанные с категорией.

]no-highlight]
" : [ { "text
[no-highlight[

Текст предупреждения.

]no-highlight]
" : "{string}", "shortText
[no-highlight[

Краткий текст предупреждения.

Предназначен для устройств с узким экраном.

]no-highlight]
" : "{string}", "age
[no-highlight[

Возрастное ограничение для категории.

]no-highlight]
" : {int32} }, ... ] } }
<result status
[no-highlight[

Статус обработки запроса.

Возможные значения:

  • OK — операция выполнена успешно.

  • ERROR — произошла ошибка.

]no-highlight]
="{enum}"> <context
[no-highlight[

Контекст обработки запроса.

]no-highlight]
id
[no-highlight[

Уникальный идентификатор запроса.

]no-highlight]
="{string}" time
[no-highlight[

Дата и время выполнения запроса в формате ISO 8601.

]no-highlight]
="{date}" marketUrl
[no-highlight[

Ссылка на Яндекс.Маркет.

]no-highlight]
="{string}"> <region
[no-highlight[

Информация о регионе запроса.

]no-highlight]
id
[no-highlight[

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

]no-highlight]
="{int32}" name
[no-highlight[

Наименование региона.

]no-highlight]
="{string}" type
[no-highlight[

Тип региона.

Возможные значения:

  • CONTINENT — континент.

  • REGION — регион.

  • COUNTRY — страна.

  • COUNTRY_DISTRICT — федеральный округ.

  • SUBJECT_FEDERATION — субъект федерации.

  • CITY — город.

  • VILLAGE — село.

  • CITY_DISTRICT — район города.

  • METRO_STATION — станиция метро.

  • SUBJECT_FEDERATION_DISTRICT — район субъекта федерации.

  • AIRPORT — аэропорт.

  • OVERSEAS_TERRITORY — отдельная территория какого-либо государства, расположенная в другой части света (например, Ангилья, Гренландия, Бермудские острова и т. д.).

  • SECONDARY_DISTRICT — район города второго уровня (например, для ВАО Москвы районами второго уровня являются Измайлово, Новокосино, Перово и т. д.).

  • MONORAIL_STATION — станция монорельса.

  • RURAL_SETTLEMENT — сельское поселение.

  • OTHER — другой тип населенного пункта.

]no-highlight]
="{enum}" childCount
[no-highlight[

Количество дочерних регионов.

]no-highlight]
="{int32}"> <country
[no-highlight[

Страна, к которой относится регион.

Регион

]no-highlight]
>Содержимое объекта</country> </region> <currency
[no-highlight[

Валюта запроса.

]no-highlight]
id
[no-highlight[

Код валюты.

]no-highlight]
="{string}" name
[no-highlight[

Название валюты.

]no-highlight]
="{string}"/> <alternateCurrency
[no-highlight[

Альтернативная валюта запроса.

]no-highlight]
id
[no-highlight[

Код валюты.

]no-highlight]
="{string}" name
[no-highlight[

Название валюты.

]no-highlight]
="{string}"/> <warnings
[no-highlight[

Список предупреждений, возникших при обработке запроса.

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

]no-highlight]
> <warning type
[no-highlight[

Тип предупрежедния.

]no-highlight]
="{string}" code
[no-highlight[

Код предупреждения.

]no-highlight]
="{string}" message
[no-highlight[

Сообщение с описанием предупреждения.

]no-highlight]
="{string}"/> ... </warnings> </context> <category
[no-highlight[

Информация о категории.

]no-highlight]
id
[no-highlight[

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

]no-highlight]
="{int32}" name
[no-highlight[

Наименование категории.

]no-highlight]
="{string}" fullName
[no-highlight[

Полное наименование категории.

]no-highlight]
="{string}" parent
[no-highlight[

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

]no-highlight]
="{int32}" adult
[no-highlight[

Признак категории, имеющей возрастное ограничение (18+).

]no-highlight]
="{boolean}" link
[no-highlight[

Ссылка на карточку категории на Яндекс.Маркете.

]no-highlight]
="{string}" childCount
[no-highlight[

Количество дочерних категорий.

]no-highlight]
="{int32}" modelCount
[no-highlight[

Количество моделей в категории.

]no-highlight]
="{int32}" offerCount
[no-highlight[

Количество товарных предложений в категории.

]no-highlight]
="{int32}" advertisingModel
[no-highlight[

Тип размещения товарных предложений в категории.

Возможные значения:

  • CPA — плата за заказы, оформленные прямо на Яндекс.Маркете.

  • CPC — плата только за клики по предложению магазина.

  • HYBRID — возможны оба варианта размещения товарных предложений в категории.

]no-highlight]
="{enum}" viewType
[no-highlight[

Тип отображения товаров в категории.

Возможные значения:

  • LIST — список.

  • GRID — сетка.

]no-highlight]
="{enum}"> <warnings
[no-highlight[

Предупреждения, связанные с категорией.

]no-highlight]
> <warning text
[no-highlight[

Текст предупреждения.

]no-highlight]
="{string}" shortText
[no-highlight[

Краткий текст предупреждения.

Предназначен для устройств с узким экраном.

]no-highlight]
="{string}" age
[no-highlight[

Возрастное ограничение для категории.

]no-highlight]
="{int32}"/> ... </warnings> </category> </result>

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

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

Enum

Статус обработки запроса.

Возможные значения:

  • OK — операция выполнена успешно.

  • ERROR — произошла ошибка.

context context

Object

Контекст обработки запроса.

category category

Object

Информация о категории.

Параметры, вложенные в context
id id

String

Уникальный идентификатор запроса.

time time

Date

Дата и время выполнения запроса в формате ISO 8601.

marketUrl marketUrl

String

Ссылка на Яндекс.Маркет.

region region

Object

Информация о регионе запроса.

currency currency

Object

Валюта запроса.

alternateCurrency alternateCurrency

Object

Альтернативная валюта запроса.

warnings warnings

Object list

Список предупреждений, возникших при обработке запроса.

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

Параметры, вложенные в context/region
id id

Int32

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

name name

String

Наименование региона.

type type

Enum

Тип региона.

Возможные значения:

  • CONTINENT — континент.

  • REGION — регион.

  • COUNTRY — страна.

  • COUNTRY_DISTRICT — федеральный округ.

  • SUBJECT_FEDERATION — субъект федерации.

  • CITY — город.

  • VILLAGE — село.

  • CITY_DISTRICT — район города.

  • METRO_STATION — станиция метро.

  • SUBJECT_FEDERATION_DISTRICT — район субъекта федерации.

  • AIRPORT — аэропорт.

  • OVERSEAS_TERRITORY — отдельная территория какого-либо государства, расположенная в другой части света (например, Ангилья, Гренландия, Бермудские острова и т. д.).

  • SECONDARY_DISTRICT — район города второго уровня (например, для ВАО Москвы районами второго уровня являются Измайлово, Новокосино, Перово и т. д.).

  • MONORAIL_STATION — станция монорельса.

  • RURAL_SETTLEMENT — сельское поселение.

  • OTHER — другой тип населенного пункта.

childCount childCount

Int32

Количество дочерних регионов.

country country

Object

Страна, к которой относится регион.

Регион

Параметры, вложенные в context/currency, context/alternateCurrency
id id

String

Код валюты.

name name

String

Название валюты.

Параметры, вложенные в context/warnings
type type

String

Тип предупрежедния.

code code

String

Код предупреждения.

message message

String

Сообщение с описанием предупреждения.

Параметры, вложенные в category
id id

Int32

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

name name

String

Наименование категории.

fullName fullName

String

Полное наименование категории.

parent parent

Int32

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

adult adult

Boolean

Признак категории, имеющей возрастное ограничение (18+).

link link

String

Ссылка на карточку категории на Яндекс.Маркете.

childCount childCount

Int32

Количество дочерних категорий.

modelCount modelCount

Int32

Количество моделей в категории.

offerCount offerCount

Int32

Количество товарных предложений в категории.

advertisingModel advertisingModel

Enum

Тип размещения товарных предложений в категории.

Возможные значения:

  • CPA — плата за заказы, оформленные прямо на Яндекс.Маркете.

  • CPC — плата только за клики по предложению магазина.

  • HYBRID — возможны оба варианта размещения товарных предложений в категории.

viewType viewType

Enum

Тип отображения товаров в категории.

Возможные значения:

  • LIST — список.

  • GRID — сетка.

warnings warnings

Object list

Предупреждения, связанные с категорией.

Параметры, вложенные в category/warnings
text text

String

Текст предупреждения.

shortText shortText

String

Краткий текст предупреждения.

Предназначен для устройств с узким экраном.

age age

Int32

Возрастное ограничение для категории.

Возможные ошибки

В случае возникновения ошибочной ситуации сервер возвращает HTTP-статус ответа и сообщение об ошибке. Описание ошибок приведено в разделе Сообщения об ошибках.

/{version}/categories/{id} Информация о категории Категории