OSKELLY Core Admin

Использование API

Формат ответов

REST API

Все ответы должны следовать одной структуре.

Ответ на успешный запрос:

{
    "data" : { ... }
}

Ответ на ошибочный запрос:

{
    "errorData" : { ... }
}

Постраничная загрузка

В данном API постраничная загрузка осуществляется с помощью параметров запроса pageSize и pageNumber, где pageNumber - порядковый номер страницы, pageSize - количество элементов на странице. В ответе, помимо списка запрошенных ресурсов, должно приходить мета-поле totalPages, отображающее общее количество страниц для отображения и totalAmount, отображающее общее количество элементов. Запрос с детализацией по пагинации помечается тегом PAGINATED.

Пример такого ответа:

{
    "data": {
        "devices" : [ ... ],
        "totalAmount" : 100,
        "totalPages" : 10,
    }
}

Версионирование

Версия метода передается в его пути, например https://example.com/api/v1/auth/signin. Обратно совместимые изменения в API не поднимают версию метода. Если в метод требуется внести обратно несовместимые изменения, то в дспецификацию добавляется новый метод, в котором поднимается версия. Методы устаревших версий при этом помечаются тегом как DEPRECATED и через какое-то время прекращается их поддержка.

Любые изменения, включая минорные, обязаны документироваться в разделе История изменений.

Формат даты и времени

Все даты соответствуют паттернам date (yyyy-MM-dd) и date-time (yyyy-MM-dd'T'HH:mm:ss'Z') из RFC3339.

Главная
Блоки (Отдельные сущности)
Промо баннеры
Получить промобаннер
GET /promo-banners

Запрос-референс в текущей системе: /api/v2/admin/primary/promobanner/{id}

Request parameters

id
string required

Идентификатор промобаннера

Responses

200 OK
Body
Object
data
Object
promoBanner
All of
Object
id
integer read-only

Идентификатор промобаннера

Example:
123
text
string

Текст бегущей строки

One of
Object
promocode
string nullable

Промокод

Object
link
string nullable

Ссылка

Обновить промобаннера
PATCH /promo-banners

Запрос-референс в текущей системе: api/v2/admin/primary/promobanner/update

Request parameters

id
string required

Идентификатор промобаннера

Request body

All of
Object
id
integer read-only

Идентификатор промобаннера

Example:
123
text
string

Текст бегущей строки

One of
Object
promocode
string nullable

Промокод

Object
link
string nullable

Ссылка

Responses

200 OK
Body
Object
data
Object
promoBanner
All of
Object
id
integer read-only

Идентификатор промобаннера

Example:
123
text
string

Текст бегущей строки

One of
Object
promocode
string nullable

Промокод

Object
link
string nullable

Ссылка

Получить список пользовательских фильтров
PAGINATED
GET /user-filters

Request parameters

ids
array of string optional

Список идентификаторов пользовательских фильтров для загрузки

Collection format: csv
pageNumber
integer optional

Порядковый номер страницы

Example:
1
pageSize
integer optional

Количество элементов в странице

Example:
43

Responses

200 OK
Body
Object
data
Object
userFilters
Array

Список пользовательских фильтров

Object
id
integer

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

Example:
23
group
Array

Список фильтраций пользователей. Пустой массив означает добавление всех пользователей в выборке, если selectedIds также пустой.

string
Enumeration:
CELEBRITY

Селебрити

INFLUENCERS

Инфлюенсеры

STYLISTS

Стилисты

EDITORS

Редактора

OSKELLY_USERS

Пользователи OSKELLY

selectedIds
Array of integer

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

Создать пользовательский фильтр
POST /user-filters

Request body

Object
id
integer

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

Example:
23
group
Array

Список фильтраций пользователей. Пустой массив означает добавление всех пользователей в выборке, если selectedIds также пустой.

string
Enumeration:
CELEBRITY

Селебрити

INFLUENCERS

Инфлюенсеры

STYLISTS

Стилисты

EDITORS

Редактора

OSKELLY_USERS

Пользователи OSKELLY

selectedIds
Array of integer

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

Responses

201 Created
Body
Object
data
Object
userFilter
Object
id
integer

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

Example:
23
group
Array

Список фильтраций пользователей. Пустой массив означает добавление всех пользователей в выборке, если selectedIds также пустой.

string
Enumeration:
CELEBRITY

Селебрити

INFLUENCERS

Инфлюенсеры

STYLISTS

Стилисты

EDITORS

Редактора

OSKELLY_USERS

Пользователи OSKELLY

selectedIds
Array of integer

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

Обновить пользовательский фильтр
PATCH /user-filters/{id}

Path variables

id
string required

Идентификатор пользовательского фильтра

Request body

Object
id
integer

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

Example:
23
group
Array

Список фильтраций пользователей. Пустой массив означает добавление всех пользователей в выборке, если selectedIds также пустой.

string
Enumeration:
CELEBRITY

Селебрити

INFLUENCERS

Инфлюенсеры

STYLISTS

Стилисты

EDITORS

Редактора

OSKELLY_USERS

Пользователи OSKELLY

selectedIds
Array of integer

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

Responses

200 OK
Body
Object
data
Object
userFilter
Object
id
integer

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

Example:
23
group
Array

Список фильтраций пользователей. Пустой массив означает добавление всех пользователей в выборке, если selectedIds также пустой.

string
Enumeration:
CELEBRITY

Селебрити

INFLUENCERS

Инфлюенсеры

STYLISTS

Стилисты

EDITORS

Редактора

OSKELLY_USERS

Пользователи OSKELLY

selectedIds
Array of integer

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

Удалить пользовательский фильтр
DELETE /user-filters/{id}

Path variables

id
string required

Идентификатор пользовательского фильтра

Responses

200 OK
Баннеры
POST /api/v2/banners
PATCH /api/v2/banners/{id}
DELETE /api/v2/banners/{id}
Получить список баннеров
PAGINATED
GET /api/v2/banners

Request parameters

ids
array of string optional

Список идентификаторов баннеров, ожидаемых в ответе запроса

Collection format: csv
pageNumber
integer optional

Порядковый номер страницы

Example:
1
pageSize
integer optional

Количество элементов в странице

Example:
43

Responses

200 OK
Body
Object
data
Object
banners
Array
All of
Object
id
integer read-only

Идентификатор баннера

Example:
234
sourceType
string
Enumeration:
IMG

картинка

VIDEO

видео

sourceLink
string

Ссылка ресурс

Example:
https://example.com/img.png
title
string

Заголовок

subtitle
string

Подзаголовок

updateTime
string date-time read-only

Дата обновления баннера

One of
Object
link
string nullable

Ссылка для перехода

Object
secondaryPageId
integer nullable

Идентификатор второй главной

Example:
123
Object
productFeedId
integer nullable

Идентификатор продуктового фида

Example:
43
Создать баннер
POST /api/v2/banners

Request body

All of
Object
id
integer read-only

Идентификатор баннера

Example:
234
sourceType
string
Enumeration:
IMG

картинка

VIDEO

видео

sourceLink
string

Ссылка ресурс

Example:
https://example.com/img.png
title
string

Заголовок

subtitle
string

Подзаголовок

updateTime
string date-time read-only

Дата обновления баннера

One of
Object
link
string nullable

Ссылка для перехода

Object
secondaryPageId
integer nullable

Идентификатор второй главной

Example:
123
Object
productFeedId
integer nullable

Идентификатор продуктового фида

Example:
43

Responses

201 Created
Body
Object
data
Object
banner
All of
Object
id
integer read-only

Идентификатор баннера

Example:
234
sourceType
string
Enumeration:
IMG

картинка

VIDEO

видео

sourceLink
string

Ссылка ресурс

Example:
https://example.com/img.png
title
string

Заголовок

subtitle
string

Подзаголовок

updateTime
string date-time read-only

Дата обновления баннера

One of
Object
link
string nullable

Ссылка для перехода

Object
secondaryPageId
integer nullable

Идентификатор второй главной

Example:
123
Object
productFeedId
integer nullable

Идентификатор продуктового фида

Example:
43
Редактировать баннер
PATCH /api/v2/banners/{id}

Path variables

id
string required

Идентификатор баннера

Request body

All of
Object
id
integer read-only

Идентификатор баннера

Example:
234
sourceType
string
Enumeration:
IMG

картинка

VIDEO

видео

sourceLink
string

Ссылка ресурс

Example:
https://example.com/img.png
title
string

Заголовок

subtitle
string

Подзаголовок

updateTime
string date-time read-only

Дата обновления баннера

One of
Object
link
string nullable

Ссылка для перехода

Object
secondaryPageId
integer nullable

Идентификатор второй главной

Example:
123
Object
productFeedId
integer nullable

Идентификатор продуктового фида

Example:
43

Responses

200 OK
Body
Object
data
Object
banner
All of
Object
id
integer read-only

Идентификатор баннера

Example:
234
sourceType
string
Enumeration:
IMG

картинка

VIDEO

видео

sourceLink
string

Ссылка ресурс

Example:
https://example.com/img.png
title
string

Заголовок

subtitle
string

Подзаголовок

updateTime
string date-time read-only

Дата обновления баннера

One of
Object
link
string nullable

Ссылка для перехода

Object
secondaryPageId
integer nullable

Идентификатор второй главной

Example:
123
Object
productFeedId
integer nullable

Идентификатор продуктового фида

Example:
43
Удалить баннер
DELETE /api/v2/banners/{id}

Path variables

id
string required

Идентификатор баннера

Responses

200 OK
Получить список фидов
PAGINATED
GET /feeds

Request parameters

ids
array of string optional

Список фидов для загрузки

Collection format: csv
pageNumber
integer optional

Порядковый номер страницы

Example:
1
pageSize
integer optional

Количество элементов в странице

Example:
43

Responses

200 OK
Body
Object
data
Object
feeds
Array
Object
id
integer read-only

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

Example:
123
sourceType
string
Enumeration:
IMG

картинка

VIDEO

видео

sourceLink
string

Ссылка ресурс

Example:
https://example.com/img.png
title
string

Заголовок

subtitle
string

Подзаголовок

productFeedId
integer

Идентификатор продуктового фида

Example:
43
updateTime
string date-time read-only

Дата обновления фида

Создать фид
POST /feeds

Request body

Object
id
integer read-only

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

Example:
123
sourceType
string
Enumeration:
IMG

картинка

VIDEO

видео

sourceLink
string

Ссылка ресурс

Example:
https://example.com/img.png
title
string

Заголовок

subtitle
string

Подзаголовок

productFeedId
integer

Идентификатор продуктового фида

Example:
43
updateTime
string date-time read-only

Дата обновления фида

Responses

201 Created
Body
Object
data
Object
feed
Object
id
integer read-only

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

Example:
123
sourceType
string
Enumeration:
IMG

картинка

VIDEO

видео

sourceLink
string

Ссылка ресурс

Example:
https://example.com/img.png
title
string

Заголовок

subtitle
string

Подзаголовок

productFeedId
integer

Идентификатор продуктового фида

Example:
43
updateTime
string date-time read-only

Дата обновления фида

Редактировать фид
PATCH /feeds/{id}

Path variables

id
string required

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

Request body

Object
id
integer read-only

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

Example:
123
sourceType
string
Enumeration:
IMG

картинка

VIDEO

видео

sourceLink
string

Ссылка ресурс

Example:
https://example.com/img.png
title
string

Заголовок

subtitle
string

Подзаголовок

productFeedId
integer

Идентификатор продуктового фида

Example:
43
updateTime
string date-time read-only

Дата обновления фида

Responses

200 OK
Body
Object
data
Object
feed
Object
id
integer read-only

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

Example:
123
sourceType
string
Enumeration:
IMG

картинка

VIDEO

видео

sourceLink
string

Ссылка ресурс

Example:
https://example.com/img.png
title
string

Заголовок

subtitle
string

Подзаголовок

productFeedId
integer

Идентификатор продуктового фида

Example:
43
updateTime
string date-time read-only

Дата обновления фида

Удалить фид
DELETE /feeds/{id}

Path variables

id
string required

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

Responses

200 OK
Фид товарный
Получить список товарных фидов
PAGINATED
GET /product-feeds

Request parameters

ids
array of string optional

Список товарных фидов для загрузки

Collection format: csv
pageNumber
integer required

Порядковый номер страницы

Example:
1
pageSize
integer required

Количество элементов в странице

Example:
30

Responses

200 OK
Body
Object
data
Object
productFeeds
Array

Список товарных фидов

Object
id
integer read-only

Идентификатор продуктового фида

Example:
123
title
string nullable

Название продуктового фида

Example:
Новинки лета 2025
includedUserIds
Array of integer

Список идентификаторов включенных продавцов

includedUserType
string

Тип продавца

Enumeration:
INDIVIDUAL
CONSIGNMENT_SHOP
BOUTIQUE
BRAND
BUYER
excludedUserIds
Array of integer

Список идентификаторов исключенных продавцов

excludedUserType
string

Тип продавца

Enumeration:
INDIVIDUAL
CONSIGNMENT_SHOP
BOUTIQUE
BRAND
BUYER
IncludedCategoryIds
Array of integer

Список идентификаторов включенных категорий

IncludedBrandIds
Array of integer

Список идентификаторов включенных брендов

includedModelIds
Array of integer

Список идентификаторов включенных моделей

excludedCategoryIds
Array of integer

Список идентификаторов исключенных категорий

excludedBrandIds
Array of integer

Список идентификаторов исключенных брэндов

excludedModelIds
Array of integer

Список идентификаторов исключенных моделей

materialIds
Array of integer

Список идентификаторов материалов

colorIds
Array of integer

Список идентификаторов цветов

productConditionIds
Array of integer

Список идентификаторов состояний товара

priceFrom
integer

Цена от

Example:
100
priceTo
integer

Цена до

Example:
300
boutiqueIds
Array of integer

Список идентификаторов бутиков

seasons
Array

Список сезонов коллекции

string
Enumeration:
SPRING_SUMMER

Весна-лето

AUTUMN_WINTER

Осень-зима

years
Array of integer

Список годов

isCarryOver
boolean

Флаг базового гардероб

commercialBadges
Array

Список коммерческих бэйджей

string
Enumeration:
SALE

Sale

OUTLET

Аутлет

CAN_RETURN

Доступен возврат

OSKELLY_CHOICE

Выбор OSKELLY

VINTAGE

Винтаж

INVESTMENTS

Инвестиции

SELLER_DISCOUNT

Скидка от продавца

OSKELLY_EXCLUSIVE

Доступно только в бутике OSKELLY

FAST_DELIVERY_FROM_STOCKS

Быстрая доставка: товар на складе

CELEBRITY_WARDROBE

Звездный гардероб

commercialTags
Array

Список коммерческих тегов

string
Enumeration:
STREETWEAR

Streetwear

COLLECTABLES

Collectables

HERMES_BAGS

Hermes Bags

HOME

Home

BEAUTY

Beauty

TECH

Tech

JEWELERY

Jewelry

WATCHES

Watches

deliveryTimeIds
Array of integer

Список идентификаторов сроков доставки. Проверить есть ли такой запрос

isFromAbroad
boolean

Флаг из-за рубежа

productIds
Array of integer

Список идентификаторов товаров

productTotal
integer

Количество товаров, соотвествующих параметрам фида

Example:
123
sectionId
integer nullable

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

Example:
531
updateTime
string date-time read-only

Дата обновления товарного фида

Создать товарный фид
POST /product-feeds

Request body

Object
id
integer read-only

Идентификатор продуктового фида

Example:
123
title
string nullable

Название продуктового фида

Example:
Новинки лета 2025
includedUserIds
Array of integer

Список идентификаторов включенных продавцов

includedUserType
string

Тип продавца

Enumeration:
INDIVIDUAL
CONSIGNMENT_SHOP
BOUTIQUE
BRAND
BUYER
excludedUserIds
Array of integer

Список идентификаторов исключенных продавцов

excludedUserType
string

Тип продавца

Enumeration:
INDIVIDUAL
CONSIGNMENT_SHOP
BOUTIQUE
BRAND
BUYER
IncludedCategoryIds
Array of integer

Список идентификаторов включенных категорий

IncludedBrandIds
Array of integer

Список идентификаторов включенных брендов

includedModelIds
Array of integer

Список идентификаторов включенных моделей

excludedCategoryIds
Array of integer

Список идентификаторов исключенных категорий

excludedBrandIds
Array of integer

Список идентификаторов исключенных брэндов

excludedModelIds
Array of integer

Список идентификаторов исключенных моделей

materialIds
Array of integer

Список идентификаторов материалов

colorIds
Array of integer

Список идентификаторов цветов

productConditionIds
Array of integer

Список идентификаторов состояний товара

priceFrom
integer

Цена от

Example:
100
priceTo
integer

Цена до

Example:
300
boutiqueIds
Array of integer

Список идентификаторов бутиков

seasons
Array

Список сезонов коллекции

string
Enumeration:
SPRING_SUMMER

Весна-лето

AUTUMN_WINTER

Осень-зима

years
Array of integer

Список годов

isCarryOver
boolean

Флаг базового гардероб

commercialBadges
Array

Список коммерческих бэйджей

string
Enumeration:
SALE

Sale

OUTLET

Аутлет

CAN_RETURN

Доступен возврат

OSKELLY_CHOICE

Выбор OSKELLY

VINTAGE

Винтаж

INVESTMENTS

Инвестиции

SELLER_DISCOUNT

Скидка от продавца

OSKELLY_EXCLUSIVE

Доступно только в бутике OSKELLY

FAST_DELIVERY_FROM_STOCKS

Быстрая доставка: товар на складе

CELEBRITY_WARDROBE

Звездный гардероб

commercialTags
Array

Список коммерческих тегов

string
Enumeration:
STREETWEAR

Streetwear

COLLECTABLES

Collectables

HERMES_BAGS

Hermes Bags

HOME

Home

BEAUTY

Beauty

TECH

Tech

JEWELERY

Jewelry

WATCHES

Watches

deliveryTimeIds
Array of integer

Список идентификаторов сроков доставки. Проверить есть ли такой запрос

isFromAbroad
boolean

Флаг из-за рубежа

productIds
Array of integer

Список идентификаторов товаров

productTotal
integer

Количество товаров, соотвествующих параметрам фида

Example:
123
sectionId
integer nullable

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

Example:
531
updateTime
string date-time read-only

Дата обновления товарного фида

Responses

201 Created
Body
Object
data
Object
productFeed
Object
id
integer read-only

Идентификатор продуктового фида

Example:
123
title
string nullable

Название продуктового фида

Example:
Новинки лета 2025
includedUserIds
Array of integer

Список идентификаторов включенных продавцов

includedUserType
string

Тип продавца

Enumeration:
INDIVIDUAL
CONSIGNMENT_SHOP
BOUTIQUE
BRAND
BUYER
excludedUserIds
Array of integer

Список идентификаторов исключенных продавцов

excludedUserType
string

Тип продавца

Enumeration:
INDIVIDUAL
CONSIGNMENT_SHOP
BOUTIQUE
BRAND
BUYER
IncludedCategoryIds
Array of integer

Список идентификаторов включенных категорий

IncludedBrandIds
Array of integer

Список идентификаторов включенных брендов

includedModelIds
Array of integer

Список идентификаторов включенных моделей

excludedCategoryIds
Array of integer

Список идентификаторов исключенных категорий

excludedBrandIds
Array of integer

Список идентификаторов исключенных брэндов

excludedModelIds
Array of integer

Список идентификаторов исключенных моделей

materialIds
Array of integer

Список идентификаторов материалов

colorIds
Array of integer

Список идентификаторов цветов

productConditionIds
Array of integer

Список идентификаторов состояний товара

priceFrom
integer

Цена от

Example:
100
priceTo
integer

Цена до

Example:
300
boutiqueIds
Array of integer

Список идентификаторов бутиков

seasons
Array

Список сезонов коллекции

string
Enumeration:
SPRING_SUMMER

Весна-лето

AUTUMN_WINTER

Осень-зима

years
Array of integer

Список годов

isCarryOver
boolean

Флаг базового гардероб

commercialBadges
Array

Список коммерческих бэйджей

string
Enumeration:
SALE

Sale

OUTLET

Аутлет

CAN_RETURN

Доступен возврат

OSKELLY_CHOICE

Выбор OSKELLY

VINTAGE

Винтаж

INVESTMENTS

Инвестиции

SELLER_DISCOUNT

Скидка от продавца

OSKELLY_EXCLUSIVE

Доступно только в бутике OSKELLY

FAST_DELIVERY_FROM_STOCKS

Быстрая доставка: товар на складе

CELEBRITY_WARDROBE

Звездный гардероб

commercialTags
Array

Список коммерческих тегов

string
Enumeration:
STREETWEAR

Streetwear

COLLECTABLES

Collectables

HERMES_BAGS

Hermes Bags

HOME

Home

BEAUTY

Beauty

TECH

Tech

JEWELERY

Jewelry

WATCHES

Watches

deliveryTimeIds
Array of integer

Список идентификаторов сроков доставки. Проверить есть ли такой запрос

isFromAbroad
boolean

Флаг из-за рубежа

productIds
Array of integer

Список идентификаторов товаров

productTotal
integer

Количество товаров, соотвествующих параметрам фида

Example:
123
sectionId
integer nullable

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

Example:
531
updateTime
string date-time read-only

Дата обновления товарного фида

Обновить товарный фид
PATCH /product-feeds/{id}

Path variables

id
integer required

Идентификатор продуктового фида

Request body

Object
id
integer read-only

Идентификатор продуктового фида

Example:
123
title
string nullable

Название продуктового фида

Example:
Новинки лета 2025
includedUserIds
Array of integer

Список идентификаторов включенных продавцов

includedUserType
string

Тип продавца

Enumeration:
INDIVIDUAL
CONSIGNMENT_SHOP
BOUTIQUE
BRAND
BUYER
excludedUserIds
Array of integer

Список идентификаторов исключенных продавцов

excludedUserType
string

Тип продавца

Enumeration:
INDIVIDUAL
CONSIGNMENT_SHOP
BOUTIQUE
BRAND
BUYER
IncludedCategoryIds
Array of integer

Список идентификаторов включенных категорий

IncludedBrandIds
Array of integer

Список идентификаторов включенных брендов

includedModelIds
Array of integer

Список идентификаторов включенных моделей

excludedCategoryIds
Array of integer

Список идентификаторов исключенных категорий

excludedBrandIds
Array of integer

Список идентификаторов исключенных брэндов

excludedModelIds
Array of integer

Список идентификаторов исключенных моделей

materialIds
Array of integer

Список идентификаторов материалов

colorIds
Array of integer

Список идентификаторов цветов

productConditionIds
Array of integer

Список идентификаторов состояний товара

priceFrom
integer

Цена от

Example:
100
priceTo
integer

Цена до

Example:
300
boutiqueIds
Array of integer

Список идентификаторов бутиков

seasons
Array

Список сезонов коллекции

string
Enumeration:
SPRING_SUMMER

Весна-лето

AUTUMN_WINTER

Осень-зима

years
Array of integer

Список годов

isCarryOver
boolean

Флаг базового гардероб

commercialBadges
Array

Список коммерческих бэйджей

string
Enumeration:
SALE

Sale

OUTLET

Аутлет

CAN_RETURN

Доступен возврат

OSKELLY_CHOICE

Выбор OSKELLY

VINTAGE

Винтаж

INVESTMENTS

Инвестиции

SELLER_DISCOUNT

Скидка от продавца

OSKELLY_EXCLUSIVE

Доступно только в бутике OSKELLY

FAST_DELIVERY_FROM_STOCKS

Быстрая доставка: товар на складе

CELEBRITY_WARDROBE

Звездный гардероб

commercialTags
Array

Список коммерческих тегов

string
Enumeration:
STREETWEAR

Streetwear

COLLECTABLES

Collectables

HERMES_BAGS

Hermes Bags

HOME

Home

BEAUTY

Beauty

TECH

Tech

JEWELERY

Jewelry

WATCHES

Watches

deliveryTimeIds
Array of integer

Список идентификаторов сроков доставки. Проверить есть ли такой запрос

isFromAbroad
boolean

Флаг из-за рубежа

productIds
Array of integer

Список идентификаторов товаров

productTotal
integer

Количество товаров, соотвествующих параметрам фида

Example:
123
sectionId
integer nullable

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

Example:
531
updateTime
string date-time read-only

Дата обновления товарного фида

Responses

200 OK
Body
Object
data
Object
productFeed
Object
id
integer read-only

Идентификатор продуктового фида

Example:
123
title
string nullable

Название продуктового фида

Example:
Новинки лета 2025
includedUserIds
Array of integer

Список идентификаторов включенных продавцов

includedUserType
string

Тип продавца

Enumeration:
INDIVIDUAL
CONSIGNMENT_SHOP
BOUTIQUE
BRAND
BUYER
excludedUserIds
Array of integer

Список идентификаторов исключенных продавцов

excludedUserType
string

Тип продавца

Enumeration:
INDIVIDUAL
CONSIGNMENT_SHOP
BOUTIQUE
BRAND
BUYER
IncludedCategoryIds
Array of integer

Список идентификаторов включенных категорий

IncludedBrandIds
Array of integer

Список идентификаторов включенных брендов

includedModelIds
Array of integer

Список идентификаторов включенных моделей

excludedCategoryIds
Array of integer

Список идентификаторов исключенных категорий

excludedBrandIds
Array of integer

Список идентификаторов исключенных брэндов

excludedModelIds
Array of integer

Список идентификаторов исключенных моделей

materialIds
Array of integer

Список идентификаторов материалов

colorIds
Array of integer

Список идентификаторов цветов

productConditionIds
Array of integer

Список идентификаторов состояний товара

priceFrom
integer

Цена от

Example:
100
priceTo
integer

Цена до

Example:
300
boutiqueIds
Array of integer

Список идентификаторов бутиков

seasons
Array

Список сезонов коллекции

string
Enumeration:
SPRING_SUMMER

Весна-лето

AUTUMN_WINTER

Осень-зима

years
Array of integer

Список годов

isCarryOver
boolean

Флаг базового гардероб

commercialBadges
Array

Список коммерческих бэйджей

string
Enumeration:
SALE

Sale

OUTLET

Аутлет

CAN_RETURN

Доступен возврат

OSKELLY_CHOICE

Выбор OSKELLY

VINTAGE

Винтаж

INVESTMENTS

Инвестиции

SELLER_DISCOUNT

Скидка от продавца

OSKELLY_EXCLUSIVE

Доступно только в бутике OSKELLY

FAST_DELIVERY_FROM_STOCKS

Быстрая доставка: товар на складе

CELEBRITY_WARDROBE

Звездный гардероб

commercialTags
Array

Список коммерческих тегов

string
Enumeration:
STREETWEAR

Streetwear

COLLECTABLES

Collectables

HERMES_BAGS

Hermes Bags

HOME

Home

BEAUTY

Beauty

TECH

Tech

JEWELERY

Jewelry

WATCHES

Watches

deliveryTimeIds
Array of integer

Список идентификаторов сроков доставки. Проверить есть ли такой запрос

isFromAbroad
boolean

Флаг из-за рубежа

productIds
Array of integer

Список идентификаторов товаров

productTotal
integer

Количество товаров, соотвествующих параметрам фида

Example:
123
sectionId
integer nullable

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

Example:
531
updateTime
string date-time read-only

Дата обновления товарного фида

Удалить товарный фид
DELETE /product-feeds/{id}

Path variables

id
integer required

Идентификатор продуктового фида

Responses

200 OK
Основные главные
GET /api/v2/admin/primary/customizablepage/main/{id}
POST /api/v2/admin/primary/customizablepage/main
PATCH /api/v2/admin/primary/customizablepage/main/{id}/publish
PATCH /api/v2/admin/primary/customizablepage/main/{id}
Получить пользовательские сегменты главной страницы
GET /api/v2/main/segments

Запрос-референс в текущей системе: /api/v2/admin/primary/page

Request parameters

type
PageType required

Тип главной

Example:
RESALE
category
PageCategory required

Категория главной

Example:
MALE

Responses

200 OK
Body
Object
data
Object
segments
Array

Список категорий главной заданного типа

Object
id
integer

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

Example:
123
title
string read-only

Назавние сегмента

Example:
Все пользователи
pageId
integer read-only

Идентификатор главной страницы заданного сегмента

Example:
123
Получить страницу
GET /api/v2/admin/primary/customizablepage/main/{id}

Запрос-референс в текущей системе: v2/admin/primary/customizablepage/setting/{id}

Path variables

id
string required

Идентификатор страницы

Request parameters

segmentId
integer required

Идентификатор сегмента страницы

Responses

200 OK
Body
Object
data
Object
id
string read-only
Example:
a10e472a-aa4b-4e80-a910-0d53478fcd03
segmentId
string nullable
Example:
a10e472a-aa4b-4e80-a910-0d53478fcd03
pageType
PageType nullable

Тип страницы

pageCategory
PageCategory nullable

Категория страницы

contentBlocks
Array nullable
Object
blockId
string nullable
Example:
a10e472a-aa4b-4e80-a910-0d53478fcd03

Тип блока

title
string nullable

Заголовок блока

description
string nullable

Подзаголвок блока

contentIds
Array of integer nullable

Идентификаторы данных. В зависимости от типа блока тип сущности отличается.

Тип блока Тип сущности
SHELF_TOP_BRANDS Бренд или Модель. Тип сущности определяется однозначно по данным из поля properties
SHELF_CUSTOM Фид товарный
SHELF_NEW_COLLECTION Категория товара
SHELF_FAST_DELIVERY Категория товара
SHELF_OSKELLY_BOUTIQUE Категория товара
SHELF_OCOMMUNITY_CHOICE Категория товара
SHELF_OSKELLY_CHOICE Категория товара
SOCIAL_OTRENDS Пользовательские фильтры
SOCIAL_CELEBRITIES Пользовательские фильтры
BANNER_WITH_TEXT Баннеры
BANNER_SLIDERS Баннеры
BANNER_PRODUCTS Фиды
contentList
Array nullable

Ссылка на данные. В зависимости от типа блока даннаые отличаются. Использовать только в случае если нет возможности описать данные в виде списка идентификаторов данных

isEnable
boolean nullable

Флаг отображения блока в МП

isPublished
boolean read-only

Флаг опубликованности изменений

updatedAt
string date-time read-only

Дата последней публикации

fixedContentBlocks
Array nullable
Object
blockId
string nullable
Example:
a10e472a-aa4b-4e80-a910-0d53478fcd03

Тип блока

contentIds
Array of integer nullable

Идентификаторы данных. В зависимости от типа блока тип сущности отличается.

Тип блока Тип сущности
MAIN_BANNER Баннеры
PROMO_BANNER Промо баннеры
isEnable
boolean nullable

Флаг отображения блока в МП

isPublished
boolean read-only

Флаг опубликованности изменений

updatedAt
string date-time read-only

Дата последней публикации

Создание главной
POST /api/v2/admin/primary/customizablepage/main

Запрос для инициализации главной. Используется для каждой категории по одному разу при начале использования. Создание новых сегментов главной страницы осуществляется через PATCH запрос

Request body

Object
id
string read-only
Example:
a10e472a-aa4b-4e80-a910-0d53478fcd03
segmentId
string nullable
Example:
a10e472a-aa4b-4e80-a910-0d53478fcd03
pageType
PageType nullable

Тип страницы

pageCategory
PageCategory nullable

Категория страницы

contentBlocks
Array nullable
Object
blockId
string nullable
Example:
a10e472a-aa4b-4e80-a910-0d53478fcd03

Тип блока

title
string nullable

Заголовок блока

description
string nullable

Подзаголвок блока

contentIds
Array of integer nullable

Идентификаторы данных. В зависимости от типа блока тип сущности отличается.

Тип блока Тип сущности
SHELF_TOP_BRANDS Бренд или Модель. Тип сущности определяется однозначно по данным из поля properties
SHELF_CUSTOM Фид товарный
SHELF_NEW_COLLECTION Категория товара
SHELF_FAST_DELIVERY Категория товара
SHELF_OSKELLY_BOUTIQUE Категория товара
SHELF_OCOMMUNITY_CHOICE Категория товара
SHELF_OSKELLY_CHOICE Категория товара
SOCIAL_OTRENDS Пользовательские фильтры
SOCIAL_CELEBRITIES Пользовательские фильтры
BANNER_WITH_TEXT Баннеры
BANNER_SLIDERS Баннеры
BANNER_PRODUCTS Фиды
contentList
Array nullable

Ссылка на данные. В зависимости от типа блока даннаые отличаются. Использовать только в случае если нет возможности описать данные в виде списка идентификаторов данных

isEnable
boolean nullable

Флаг отображения блока в МП

isPublished
boolean read-only

Флаг опубликованности изменений

updatedAt
string date-time read-only

Дата последней публикации

fixedContentBlocks
Array nullable
Object
blockId
string nullable
Example:
a10e472a-aa4b-4e80-a910-0d53478fcd03

Тип блока

contentIds
Array of integer nullable

Идентификаторы данных. В зависимости от типа блока тип сущности отличается.

Тип блока Тип сущности
MAIN_BANNER Баннеры
PROMO_BANNER Промо баннеры
isEnable
boolean nullable

Флаг отображения блока в МП

isPublished
boolean read-only

Флаг опубликованности изменений

updatedAt
string date-time read-only

Дата последней публикации

Responses

200 OK
Body
Object
data
Object
id
string read-only
Example:
a10e472a-aa4b-4e80-a910-0d53478fcd03
segmentId
string nullable
Example:
a10e472a-aa4b-4e80-a910-0d53478fcd03
pageType
PageType nullable

Тип страницы

pageCategory
PageCategory nullable

Категория страницы

contentBlocks
Array nullable
Object
blockId
string nullable
Example:
a10e472a-aa4b-4e80-a910-0d53478fcd03

Тип блока

title
string nullable

Заголовок блока

description
string nullable

Подзаголвок блока

contentIds
Array of integer nullable

Идентификаторы данных. В зависимости от типа блока тип сущности отличается.

Тип блока Тип сущности
SHELF_TOP_BRANDS Бренд или Модель. Тип сущности определяется однозначно по данным из поля properties
SHELF_CUSTOM Фид товарный
SHELF_NEW_COLLECTION Категория товара
SHELF_FAST_DELIVERY Категория товара
SHELF_OSKELLY_BOUTIQUE Категория товара
SHELF_OCOMMUNITY_CHOICE Категория товара
SHELF_OSKELLY_CHOICE Категория товара
SOCIAL_OTRENDS Пользовательские фильтры
SOCIAL_CELEBRITIES Пользовательские фильтры
BANNER_WITH_TEXT Баннеры
BANNER_SLIDERS Баннеры
BANNER_PRODUCTS Фиды
contentList
Array nullable

Ссылка на данные. В зависимости от типа блока даннаые отличаются. Использовать только в случае если нет возможности описать данные в виде списка идентификаторов данных

isEnable
boolean nullable

Флаг отображения блока в МП

isPublished
boolean read-only

Флаг опубликованности изменений

updatedAt
string date-time read-only

Дата последней публикации

fixedContentBlocks
Array nullable
Object
blockId
string nullable
Example:
a10e472a-aa4b-4e80-a910-0d53478fcd03

Тип блока

contentIds
Array of integer nullable

Идентификаторы данных. В зависимости от типа блока тип сущности отличается.

Тип блока Тип сущности
MAIN_BANNER Баннеры
PROMO_BANNER Промо баннеры
isEnable
boolean nullable

Флаг отображения блока в МП

isPublished
boolean read-only

Флаг опубликованности изменений

updatedAt
string date-time read-only

Дата последней публикации

Опубликовать страницу
PATCH /api/v2/admin/primary/customizablepage/main/{id}/publish

Path variables

id
string required

Идентификатор главной

Request parameters

segmentId
string required

Идентификатор сегмента пользователей

Responses

200 OK
Body
Object
data
Object
id
string read-only
Example:
a10e472a-aa4b-4e80-a910-0d53478fcd03
segmentId
string nullable
Example:
a10e472a-aa4b-4e80-a910-0d53478fcd03
pageType
PageType nullable

Тип страницы

pageCategory
PageCategory nullable

Категория страницы

contentBlocks
Array nullable
Object
blockId
string nullable
Example:
a10e472a-aa4b-4e80-a910-0d53478fcd03

Тип блока

title
string nullable

Заголовок блока

description
string nullable

Подзаголвок блока

contentIds
Array of integer nullable

Идентификаторы данных. В зависимости от типа блока тип сущности отличается.

Тип блока Тип сущности
SHELF_TOP_BRANDS Бренд или Модель. Тип сущности определяется однозначно по данным из поля properties
SHELF_CUSTOM Фид товарный
SHELF_NEW_COLLECTION Категория товара
SHELF_FAST_DELIVERY Категория товара
SHELF_OSKELLY_BOUTIQUE Категория товара
SHELF_OCOMMUNITY_CHOICE Категория товара
SHELF_OSKELLY_CHOICE Категория товара
SOCIAL_OTRENDS Пользовательские фильтры
SOCIAL_CELEBRITIES Пользовательские фильтры
BANNER_WITH_TEXT Баннеры
BANNER_SLIDERS Баннеры
BANNER_PRODUCTS Фиды
contentList
Array nullable

Ссылка на данные. В зависимости от типа блока даннаые отличаются. Использовать только в случае если нет возможности описать данные в виде списка идентификаторов данных

isEnable
boolean nullable

Флаг отображения блока в МП

isPublished
boolean read-only

Флаг опубликованности изменений

updatedAt
string date-time read-only

Дата последней публикации

fixedContentBlocks
Array nullable
Object
blockId
string nullable
Example:
a10e472a-aa4b-4e80-a910-0d53478fcd03

Тип блока

contentIds
Array of integer nullable

Идентификаторы данных. В зависимости от типа блока тип сущности отличается.

Тип блока Тип сущности
MAIN_BANNER Баннеры
PROMO_BANNER Промо баннеры
isEnable
boolean nullable

Флаг отображения блока в МП

isPublished
boolean read-only

Флаг опубликованности изменений

updatedAt
string date-time read-only

Дата последней публикации

Редактировать страницу
PATCH /api/v2/admin/primary/customizablepage/main/{id}

Запрос-референс в текущей системе: v2/admin/primary/customizablepage/setting/update

Path variables

id
string required

Идентификатор страницы

Request body

Object
id
string read-only
Example:
a10e472a-aa4b-4e80-a910-0d53478fcd03
segmentId
string nullable
Example:
a10e472a-aa4b-4e80-a910-0d53478fcd03
pageType
PageType nullable

Тип страницы

pageCategory
PageCategory nullable

Категория страницы

contentBlocks
Array nullable
Object
blockId
string nullable
Example:
a10e472a-aa4b-4e80-a910-0d53478fcd03

Тип блока

title
string nullable

Заголовок блока

description
string nullable

Подзаголвок блока

contentIds
Array of integer nullable

Идентификаторы данных. В зависимости от типа блока тип сущности отличается.

Тип блока Тип сущности
SHELF_TOP_BRANDS Бренд или Модель. Тип сущности определяется однозначно по данным из поля properties
SHELF_CUSTOM Фид товарный
SHELF_NEW_COLLECTION Категория товара
SHELF_FAST_DELIVERY Категория товара
SHELF_OSKELLY_BOUTIQUE Категория товара
SHELF_OCOMMUNITY_CHOICE Категория товара
SHELF_OSKELLY_CHOICE Категория товара
SOCIAL_OTRENDS Пользовательские фильтры
SOCIAL_CELEBRITIES Пользовательские фильтры
BANNER_WITH_TEXT Баннеры
BANNER_SLIDERS Баннеры
BANNER_PRODUCTS Фиды
contentList
Array nullable

Ссылка на данные. В зависимости от типа блока даннаые отличаются. Использовать только в случае если нет возможности описать данные в виде списка идентификаторов данных

isEnable
boolean nullable

Флаг отображения блока в МП

isPublished
boolean read-only

Флаг опубликованности изменений

updatedAt
string date-time read-only

Дата последней публикации

fixedContentBlocks
Array nullable
Object
blockId
string nullable
Example:
a10e472a-aa4b-4e80-a910-0d53478fcd03

Тип блока

contentIds
Array of integer nullable

Идентификаторы данных. В зависимости от типа блока тип сущности отличается.

Тип блока Тип сущности
MAIN_BANNER Баннеры
PROMO_BANNER Промо баннеры
isEnable
boolean nullable

Флаг отображения блока в МП

isPublished
boolean read-only

Флаг опубликованности изменений

updatedAt
string date-time read-only

Дата последней публикации

Responses

200 OK
Body
Object
data
Object
id
string read-only
Example:
a10e472a-aa4b-4e80-a910-0d53478fcd03
segmentId
string nullable
Example:
a10e472a-aa4b-4e80-a910-0d53478fcd03
pageType
PageType nullable

Тип страницы

pageCategory
PageCategory nullable

Категория страницы

contentBlocks
Array nullable
Object
blockId
string nullable
Example:
a10e472a-aa4b-4e80-a910-0d53478fcd03

Тип блока

title
string nullable

Заголовок блока

description
string nullable

Подзаголвок блока

contentIds
Array of integer nullable

Идентификаторы данных. В зависимости от типа блока тип сущности отличается.

Тип блока Тип сущности
SHELF_TOP_BRANDS Бренд или Модель. Тип сущности определяется однозначно по данным из поля properties
SHELF_CUSTOM Фид товарный
SHELF_NEW_COLLECTION Категория товара
SHELF_FAST_DELIVERY Категория товара
SHELF_OSKELLY_BOUTIQUE Категория товара
SHELF_OCOMMUNITY_CHOICE Категория товара
SHELF_OSKELLY_CHOICE Категория товара
SOCIAL_OTRENDS Пользовательские фильтры
SOCIAL_CELEBRITIES Пользовательские фильтры
BANNER_WITH_TEXT Баннеры
BANNER_SLIDERS Баннеры
BANNER_PRODUCTS Фиды
contentList
Array nullable

Ссылка на данные. В зависимости от типа блока даннаые отличаются. Использовать только в случае если нет возможности описать данные в виде списка идентификаторов данных

isEnable
boolean nullable

Флаг отображения блока в МП

isPublished
boolean read-only

Флаг опубликованности изменений

updatedAt
string date-time read-only

Дата последней публикации

fixedContentBlocks
Array nullable
Object
blockId
string nullable
Example:
a10e472a-aa4b-4e80-a910-0d53478fcd03

Тип блока

contentIds
Array of integer nullable

Идентификаторы данных. В зависимости от типа блока тип сущности отличается.

Тип блока Тип сущности
MAIN_BANNER Баннеры
PROMO_BANNER Промо баннеры
isEnable
boolean nullable

Флаг отображения блока в МП

isPublished
boolean read-only

Флаг опубликованности изменений

updatedAt
string date-time read-only

Дата последней публикации

Словари
PageType
string
Enumeration:
RESALE

Ресейл

NEW

Новое из бутиков

PageCategory
string
Enumeration:
FEMALE

Женское

MALE

Мужское

TransitionType

Переход

string

Переход

Enumeration:
BUTTON

По кнопке

ARROW

По стрелке

ContentBlockType
Тип блока Ресейл Новое из бутиков Фид сегменты
SHELF_TOP_BRANDS да да -
SHELF_CUSTOM да да да
SHELF_NEW_COLLECTION - да -
SHELF_FAST_DELIVERY да да -
SHELF_OSKELLY_BOUTIQUE да да -
SHELF_OCOMMUNITY_CHOICE - да -
SHELF_OSKELLY_CHOICE да да -
SOCIAL_OTRENDS да да -
SOCIAL_CELEBRITIES да да да
BANNER_WITH_TEXT да да -
BANNER_SLIDERS - - да
BANNER_PRODUCTS - - да
SPACER да да да
FEED_SEGMENTS да да -
AD_BLOCK_SERVICES - - да
AD_BLOCK_SOCIAL - - да
AD_BLOCK_CONCEPT_STORES - - да
string
Enumeration:
SHELF_TOP_BRANDS

Полка: Топ Бренды

SHELF_CUSTOM

Полка кастомная

SHELF_NEW_COLLECTION

Новое из бутиков

SHELF_FAST_DELIVERY

Полка: Быстрая доставка

SHELF_OSKELLY_BOUTIQUE

Полка: В бутиках OSKELLY

SHELF_OCOMMUNITY_CHOICE

Полка: Выбор O!Community

SHELF_OSKELLY_CHOICE

Полка: Выбор OSKELLY

SOCIAL_OTRENDS

Social: O!Trends

SOCIAL_CELEBRITIES

Social: Селебрити

BANNER_WITH_TEXT

Баннер: Текст под баннером

BANNER_SLIDERS

Баннер: слайдеры

BANNER_PRODUCTS

Баннер: товары

SPACER

Виджет-спейсер

FEED_SEGMENTS

Фид: сегментный

AD_BLOCK_SERVICES

Рекламный блок: Services

AD_BLOCK_SOCIAL

Рекламный блок: Social

AD_BLOCK_CONCEPT_STORES

Рекламный блок: Concept Stores

FixedContentBlockType

Тип блока

string

Тип блока

Enumeration:
MAIN_BANNER

Главный баннер

PROMO_BANNER

Промо банер: бегущая строка

ONBOARDING_STOREEZ

Онбординг: Хайлайцы “Storeez”

FeedSegmentType

Тип сегмента

string

Тип сегмента

Enumeration:
NEW

Новинки

NEW_COLLECTION

Новые коллекции

PREVIOUS_SEASON

Прошлый сезон

OUTLET

Аутлет

CLASSIC

Вечная классика

SELLER_DISCOUNT

Скидка от продавца

FAST_DELIVERY

Быстрая доставка

OSKELLY_BOUTIQUE

В бутиках OSKELLY

INVESTMENTS

Инвестиции

OSKELLY_CHOICE

Выбор OSKELLY

Модели
Данные блоков
FeedSegmentsData
Object
pageId
integer

Идентификатор второй главной

Example:
123
ShelfTopBrandsData
Object
categoryId
integer nullable

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

Example:
123
brandId
integer

Идентификатор брэнда

Example:
132
modelId
integer nullable

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

Example:
543
Свойства блоков
ShelfCustomProps

Преднастроенные полки

Object
transition
TransitionType nullable

Тип перехода

transitionBtnText
string nullable

Текст на кнопке перехода

showSeller
boolean

Флаг отображения продавца

imageUrl
string nullable

Ссылка на картинку

Example:
/image.png
ShelfTopBrandsProps
Object
view
string nullable

Тип представления полки

Enumeration:
BRANDS

Брэнды

MODELS

Модели

ShelfPresetProps

Преднастроенные полки

  • SHELF_NEW_COLLECTION
  • SHELF_FAST_DELIVERY
  • SHELF_OSKELLY_BOUTIQUE
  • SHELF_OCOMMUNITY_CHOICE
  • SHELF_OSKELLY_CHOICE
Object
transition
TransitionType nullable

Переход

transitionBtnText
string nullable

Текст на кнопке перехода

showSeller
boolean nullable

Флаг отображения продавца

SocialOTrendsProps
Object
transition
TransitionType nullable
transitionBtnText
string nullable

Текст на кнопке перехода

SocialCelebritiesProps
Object
transition
TransitionType nullable
transitionBtnText
string nullable

Текст на кнопке перехода

AdvertisingBlockServicesProps
Object
blocks
Array nullable

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

string
Enumeration:
RESALE

Ресейл

CONCIERGE

Консьерж

NEW

Новое из бутиков

SELL

Продать

PERSONAL_SHOPPING

Персональный шоппинг

AUTHENTIC

Аутентика

CARE

Уход

BOUTIQUE_OSKELLY

Бутик OSKELLY

AdvertisingBlockSocialProps
Object
blocks
Array nullable

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

string
Enumeration:
OTRENDS

O!Trends

OLOYALTY

O!Loyalty

OAFFILATE

O!Affliate (Не зупущено)

OCHARITY

O!Charity (Не зупущено)

OAUCTION

O!Auction (Не зупущено)

AdvertisingBlockConceptStoresProps
Object
blocks
Array nullable

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

string
Enumeration:
STREETWEAR

Streetwear

COLLECTIBLES

Collectibles

ICONIC_BAGS

Iconic Bags

HOME

Home

BEAUTY

Beauty

TECH

Tech

JEWELERY

Jewelry

WATCHES

Watches

Получить список разделов
PAGINATED
GET /sections

Request parameters

pageNumber
integer required

Порядковый номер страницы

Example:
1
pageSize
integer required

Количество элементов в странице

Example:
30

Responses

200 OK
Body
Object
data
Object
sections
Array
Object
id
integer nullable

Идентификатор раздела. Идентификатор пустой в случае создание нового раздела.

Example:
123
title
string

Название раздела

Example:
Инфлюенсер
Обновить список разделов
PUT /sections

Request body

Object
sections
Array

Обновить список разделов

Object
id
integer nullable

Идентификатор раздела. Идентификатор пустой в случае создание нового раздела.

Example:
123
title
string

Название раздела

Example:
Инфлюенсер

Responses

200 OK
Body
Object
data
Object
sections
Array
Object
id
integer nullable

Идентификатор раздела. Идентификатор пустой в случае создание нового раздела.

Example:
123
title
string

Название раздела

Example:
Инфлюенсер
Вторые главные
Получить список вторых главных
PAGINATED
GET /secondary-pages

Запрос-референс в текущей системе: v2/admin/banner/listAll

Request parameters

q
string optional

Поиск по названию

Example:
test
sectionId
integer optional

Идентификатор раздела. По-умолчанию возвращать все разделы

ids
array of string optional

Список идентификаторов вторых главных

Collection format: csv
pageNumber
integer optional

Порядковый номер страницы

Example:
1
pageSize
integer optional

Количество элементов в странице

Example:
43

Responses

200 OK
Body
Object
data
Object
secondaryPages
Array
Object
id
integer read-only

Идентификатор станицы

Example:
123
title
string

Название

sectionId
integer nullable

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

fixedContentBlocks
Array

Список зафиксированных блоков

Object
blockId
string nullable
Example:
a10e472a-aa4b-4e80-a910-0d53478fcd03

Тип блока

contentIds
Array of integer nullable

Идентификаторы данных. В зависимости от типа блока тип сущности отличается.

Тип блока Тип сущности
MAIN_BANNER Баннеры
PROMO_BANNER Промо баннеры
isEnable
boolean nullable

Флаг отображения блока в МП

isPublished
boolean read-only

Флаг опубликованности изменений

updatedAt
string date-time read-only

Дата последней публикации

contentBlocks
Array

Список перетаскиваемых блоков

Object
blockId
string nullable
Example:
a10e472a-aa4b-4e80-a910-0d53478fcd03

Тип блока

title
string nullable

Заголовок блока

description
string nullable

Подзаголвок блока

contentIds
Array of integer nullable

Идентификаторы данных. В зависимости от типа блока тип сущности отличается.

Тип блока Тип сущности
SHELF_TOP_BRANDS Бренд или Модель. Тип сущности определяется однозначно по данным из поля properties
SHELF_CUSTOM Фид товарный
SHELF_NEW_COLLECTION Категория товара
SHELF_FAST_DELIVERY Категория товара
SHELF_OSKELLY_BOUTIQUE Категория товара
SHELF_OCOMMUNITY_CHOICE Категория товара
SHELF_OSKELLY_CHOICE Категория товара
SOCIAL_OTRENDS Пользовательские фильтры
SOCIAL_CELEBRITIES Пользовательские фильтры
BANNER_WITH_TEXT Баннеры
BANNER_SLIDERS Баннеры
BANNER_PRODUCTS Фиды
contentList
Array nullable

Ссылка на данные. В зависимости от типа блока даннаые отличаются. Использовать только в случае если нет возможности описать данные в виде списка идентификаторов данных

isEnable
boolean nullable

Флаг отображения блока в МП

isPublished
boolean read-only

Флаг опубликованности изменений

updatedAt
string date-time read-only

Дата последней публикации

updateTime
string date-time read-only

Дата обновления страницы

Создать вторую главную
POST /secondary-pages

Запрос-референс в текущей системе: v2/admin/banner/customizablepage

Request body

Object
id
integer read-only

Идентификатор станицы

Example:
123
title
string

Название

sectionId
integer nullable

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

fixedContentBlocks
Array

Список зафиксированных блоков

Object
blockId
string nullable
Example:
a10e472a-aa4b-4e80-a910-0d53478fcd03

Тип блока

contentIds
Array of integer nullable

Идентификаторы данных. В зависимости от типа блока тип сущности отличается.

Тип блока Тип сущности
MAIN_BANNER Баннеры
PROMO_BANNER Промо баннеры
isEnable
boolean nullable

Флаг отображения блока в МП

isPublished
boolean read-only

Флаг опубликованности изменений

updatedAt
string date-time read-only

Дата последней публикации

contentBlocks
Array

Список перетаскиваемых блоков

Object
blockId
string nullable
Example:
a10e472a-aa4b-4e80-a910-0d53478fcd03

Тип блока

title
string nullable

Заголовок блока

description
string nullable

Подзаголвок блока

contentIds
Array of integer nullable

Идентификаторы данных. В зависимости от типа блока тип сущности отличается.

Тип блока Тип сущности
SHELF_TOP_BRANDS Бренд или Модель. Тип сущности определяется однозначно по данным из поля properties
SHELF_CUSTOM Фид товарный
SHELF_NEW_COLLECTION Категория товара
SHELF_FAST_DELIVERY Категория товара
SHELF_OSKELLY_BOUTIQUE Категория товара
SHELF_OCOMMUNITY_CHOICE Категория товара
SHELF_OSKELLY_CHOICE Категория товара
SOCIAL_OTRENDS Пользовательские фильтры
SOCIAL_CELEBRITIES Пользовательские фильтры
BANNER_WITH_TEXT Баннеры
BANNER_SLIDERS Баннеры
BANNER_PRODUCTS Фиды
contentList
Array nullable

Ссылка на данные. В зависимости от типа блока даннаые отличаются. Использовать только в случае если нет возможности описать данные в виде списка идентификаторов данных

isEnable
boolean nullable

Флаг отображения блока в МП

isPublished
boolean read-only

Флаг опубликованности изменений

updatedAt
string date-time read-only

Дата последней публикации

updateTime
string date-time read-only

Дата обновления страницы

Responses

201 Created
Body
Object
data
Object
secondaryPage
Object
id
integer read-only

Идентификатор станицы

Example:
123
title
string

Название

sectionId
integer nullable

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

fixedContentBlocks
Array

Список зафиксированных блоков

Object
blockId
string nullable
Example:
a10e472a-aa4b-4e80-a910-0d53478fcd03

Тип блока

contentIds
Array of integer nullable

Идентификаторы данных. В зависимости от типа блока тип сущности отличается.

Тип блока Тип сущности
MAIN_BANNER Баннеры
PROMO_BANNER Промо баннеры
isEnable
boolean nullable

Флаг отображения блока в МП

isPublished
boolean read-only

Флаг опубликованности изменений

updatedAt
string date-time read-only

Дата последней публикации

contentBlocks
Array

Список перетаскиваемых блоков

Object
blockId
string nullable
Example:
a10e472a-aa4b-4e80-a910-0d53478fcd03

Тип блока

title
string nullable

Заголовок блока

description
string nullable

Подзаголвок блока

contentIds
Array of integer nullable

Идентификаторы данных. В зависимости от типа блока тип сущности отличается.

Тип блока Тип сущности
SHELF_TOP_BRANDS Бренд или Модель. Тип сущности определяется однозначно по данным из поля properties
SHELF_CUSTOM Фид товарный
SHELF_NEW_COLLECTION Категория товара
SHELF_FAST_DELIVERY Категория товара
SHELF_OSKELLY_BOUTIQUE Категория товара
SHELF_OCOMMUNITY_CHOICE Категория товара
SHELF_OSKELLY_CHOICE Категория товара
SOCIAL_OTRENDS Пользовательские фильтры
SOCIAL_CELEBRITIES Пользовательские фильтры
BANNER_WITH_TEXT Баннеры
BANNER_SLIDERS Баннеры
BANNER_PRODUCTS Фиды
contentList
Array nullable

Ссылка на данные. В зависимости от типа блока даннаые отличаются. Использовать только в случае если нет возможности описать данные в виде списка идентификаторов данных

isEnable
boolean nullable

Флаг отображения блока в МП

isPublished
boolean read-only

Флаг опубликованности изменений

updatedAt
string date-time read-only

Дата последней публикации

updateTime
string date-time read-only

Дата обновления страницы

Редактировать вторую главную
PATCH /secondary-pages/{id}

Запрос-референс в текущей системе: v2/admin/banner/customizablepage/update

Path variables

id
string required

Идентификатор страницы

Request body

Object
id
integer read-only

Идентификатор станицы

Example:
123
title
string

Название

sectionId
integer nullable

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

fixedContentBlocks
Array

Список зафиксированных блоков

Object
blockId
string nullable
Example:
a10e472a-aa4b-4e80-a910-0d53478fcd03

Тип блока

contentIds
Array of integer nullable

Идентификаторы данных. В зависимости от типа блока тип сущности отличается.

Тип блока Тип сущности
MAIN_BANNER Баннеры
PROMO_BANNER Промо баннеры
isEnable
boolean nullable

Флаг отображения блока в МП

isPublished
boolean read-only

Флаг опубликованности изменений

updatedAt
string date-time read-only

Дата последней публикации

contentBlocks
Array

Список перетаскиваемых блоков

Object
blockId
string nullable
Example:
a10e472a-aa4b-4e80-a910-0d53478fcd03

Тип блока

title
string nullable

Заголовок блока

description
string nullable

Подзаголвок блока

contentIds
Array of integer nullable

Идентификаторы данных. В зависимости от типа блока тип сущности отличается.

Тип блока Тип сущности
SHELF_TOP_BRANDS Бренд или Модель. Тип сущности определяется однозначно по данным из поля properties
SHELF_CUSTOM Фид товарный
SHELF_NEW_COLLECTION Категория товара
SHELF_FAST_DELIVERY Категория товара
SHELF_OSKELLY_BOUTIQUE Категория товара
SHELF_OCOMMUNITY_CHOICE Категория товара
SHELF_OSKELLY_CHOICE Категория товара
SOCIAL_OTRENDS Пользовательские фильтры
SOCIAL_CELEBRITIES Пользовательские фильтры
BANNER_WITH_TEXT Баннеры
BANNER_SLIDERS Баннеры
BANNER_PRODUCTS Фиды
contentList
Array nullable

Ссылка на данные. В зависимости от типа блока даннаые отличаются. Использовать только в случае если нет возможности описать данные в виде списка идентификаторов данных

isEnable
boolean nullable

Флаг отображения блока в МП

isPublished
boolean read-only

Флаг опубликованности изменений

updatedAt
string date-time read-only

Дата последней публикации

updateTime
string date-time read-only

Дата обновления страницы

Responses

200 OK
Body
Object
data
Object
secondaryPage
Object
id
integer read-only

Идентификатор станицы

Example:
123
title
string

Название

sectionId
integer nullable

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

fixedContentBlocks
Array

Список зафиксированных блоков

Object
blockId
string nullable
Example:
a10e472a-aa4b-4e80-a910-0d53478fcd03

Тип блока

contentIds
Array of integer nullable

Идентификаторы данных. В зависимости от типа блока тип сущности отличается.

Тип блока Тип сущности
MAIN_BANNER Баннеры
PROMO_BANNER Промо баннеры
isEnable
boolean nullable

Флаг отображения блока в МП

isPublished
boolean read-only

Флаг опубликованности изменений

updatedAt
string date-time read-only

Дата последней публикации

contentBlocks
Array

Список перетаскиваемых блоков

Object
blockId
string nullable
Example:
a10e472a-aa4b-4e80-a910-0d53478fcd03

Тип блока

title
string nullable

Заголовок блока

description
string nullable

Подзаголвок блока

contentIds
Array of integer nullable

Идентификаторы данных. В зависимости от типа блока тип сущности отличается.

Тип блока Тип сущности
SHELF_TOP_BRANDS Бренд или Модель. Тип сущности определяется однозначно по данным из поля properties
SHELF_CUSTOM Фид товарный
SHELF_NEW_COLLECTION Категория товара
SHELF_FAST_DELIVERY Категория товара
SHELF_OSKELLY_BOUTIQUE Категория товара
SHELF_OCOMMUNITY_CHOICE Категория товара
SHELF_OSKELLY_CHOICE Категория товара
SOCIAL_OTRENDS Пользовательские фильтры
SOCIAL_CELEBRITIES Пользовательские фильтры
BANNER_WITH_TEXT Баннеры
BANNER_SLIDERS Баннеры
BANNER_PRODUCTS Фиды
contentList
Array nullable

Ссылка на данные. В зависимости от типа блока даннаые отличаются. Использовать только в случае если нет возможности описать данные в виде списка идентификаторов данных

isEnable
boolean nullable

Флаг отображения блока в МП

isPublished
boolean read-only

Флаг опубликованности изменений

updatedAt
string date-time read-only

Дата последней публикации

updateTime
string date-time read-only

Дата обновления страницы

Удалить вторую главную
DELETE /secondary-pages/{id}

Запрос-референс в текущей системе: v2/admin/banner/delete/{id}

Path variables

id
string required

Идентификатор страницы

Responses

200 OK
Картинки и видео
POST /api/v2/image/upload/single
Закгрузка нового ресурса
OSKELLY_API
POST /api/v2/image/upload/single

Request body

multipart/form-data
Object
image
string binary

Responses

200 OK
Body
Object
data
Object
extension
string

Расширение ресурса

imageUrl
string

Ссылка на ресурс

name
string

Название ресурса

path
string

Путь до ресурса

Получить список товаров
PAGINATED
POST /products

Запрос референс в текущей системе: /v2/catalog/products-post

Request parameters

pageNumber
integer required

Порядковый номер страницы

Example:
1
pageSize
integer required

Количество элементов в странице

Example:
30

Request body

One of
Object
id
integer read-only

Идентификатор продуктового фида

Example:
123
title
string nullable

Название продуктового фида

Example:
Новинки лета 2025
includedUserIds
Array of integer

Список идентификаторов включенных продавцов

includedUserType
string

Тип продавца

Enumeration:
INDIVIDUAL
CONSIGNMENT_SHOP
BOUTIQUE
BRAND
BUYER
excludedUserIds
Array of integer

Список идентификаторов исключенных продавцов

excludedUserType
string

Тип продавца

Enumeration:
INDIVIDUAL
CONSIGNMENT_SHOP
BOUTIQUE
BRAND
BUYER
IncludedCategoryIds
Array of integer

Список идентификаторов включенных категорий

IncludedBrandIds
Array of integer

Список идентификаторов включенных брендов

includedModelIds
Array of integer

Список идентификаторов включенных моделей

excludedCategoryIds
Array of integer

Список идентификаторов исключенных категорий

excludedBrandIds
Array of integer

Список идентификаторов исключенных брэндов

excludedModelIds
Array of integer

Список идентификаторов исключенных моделей

materialIds
Array of integer

Список идентификаторов материалов

colorIds
Array of integer

Список идентификаторов цветов

productConditionIds
Array of integer

Список идентификаторов состояний товара

priceFrom
integer

Цена от

Example:
100
priceTo
integer

Цена до

Example:
300
boutiqueIds
Array of integer

Список идентификаторов бутиков

seasons
Array

Список сезонов коллекции

string
Enumeration:
SPRING_SUMMER

Весна-лето

AUTUMN_WINTER

Осень-зима

years
Array of integer

Список годов

isCarryOver
boolean

Флаг базового гардероб

commercialBadges
Array

Список коммерческих бэйджей

string
Enumeration:
SALE

Sale

OUTLET

Аутлет

CAN_RETURN

Доступен возврат

OSKELLY_CHOICE

Выбор OSKELLY

VINTAGE

Винтаж

INVESTMENTS

Инвестиции

SELLER_DISCOUNT

Скидка от продавца

OSKELLY_EXCLUSIVE

Доступно только в бутике OSKELLY

FAST_DELIVERY_FROM_STOCKS

Быстрая доставка: товар на складе

CELEBRITY_WARDROBE

Звездный гардероб

commercialTags
Array

Список коммерческих тегов

string
Enumeration:
STREETWEAR

Streetwear

COLLECTABLES

Collectables

HERMES_BAGS

Hermes Bags

HOME

Home

BEAUTY

Beauty

TECH

Tech

JEWELERY

Jewelry

WATCHES

Watches

deliveryTimeIds
Array of integer

Список идентификаторов сроков доставки. Проверить есть ли такой запрос

isFromAbroad
boolean

Флаг из-за рубежа

productIds
Array of integer

Список идентификаторов товаров

productTotal
integer

Количество товаров, соотвествующих параметрам фида

Example:
123
sectionId
integer nullable

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

Example:
531
updateTime
string date-time read-only

Дата обновления товарного фида

Object
productIds
Array of integer

Список идентификаторов товаров

Responses

200 OK
Body
Object
data
Object
products
Array

Список товаров

Object
id
integer

Идентификатор товара

Example:
123
src
string

Ссылка на

title
string
Промокоды
Получить список промокодов
OSKELLY_API
GET /v2/admin/promocodes

Существующий запрос из текущей системы API