Xsolla-logo

Получение списка продаваемых товаров

get/v2/project/{project_id}/items

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

Внимание

Все проекты имеют ограничение на количество товаров, которые вы можете получить в ответе. Значение по умолчанию и максимальное значение — 50 товаров на ответ. Чтобы получить больше данных постранично, используйте поля limit и offset.

Примечание

В целом, использование каталога товаров доступно без авторизации.
Только авторизованные пользователи могут получать персонализированный каталог.
SecurityXsollaLoginUserJWT
Request
path Parameters
project_id
required
integer

ID проекта. Вы можете найти этот параметр в Личном кабинете рядом с названием проекта.

Example: 59080
query Parameters
limit
integer

Лимит количества элементов на странице.

Example: limit=50
offset
integer

Номер элемента, с которого выполняется вывод на странице (нумерация ведется с 0).

Example: offset=0
locale
string
Default: "en"

Язык ответа. Двухбуквенный код языка в нижнем регистре в соответствии с ISO 639-1.

additional_fields[]
Array of strings

Список дополнительных полей. Эти поля будут указаны в ответе, если вы отправите их в своем запросе.

Items Enum: "media_list" "order" "long_description" "custom_attributes"
country
string

Двухбуквенный код страны в верхнем регистре согласно ISO 3166-1 alpha 2. Показывает региональные цены и ограничения для каталога, если они были указаны при создании товара.

Примечание

Если вы явно не укажете страну, она будет установлена на основе IP-адреса пользователя.

Example: country=US
promo_code
string [ 1 .. 128 ] characters

Уникальный код, чувствительный к регистру. Содержит буквы и цифры.

Example: promo_code=WINTER2021
show_inactive_time_limited_items
integer
Default: 0

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

Example: show_inactive_time_limited_items=1
Responses
200

Список продаваемых товаров успешно получен.

Request samples
Response samples
application/json
{
  • "has_more": false,
  • "items": [
    ]
}