Xsolla-logo

Получение списка игр по указанной группеClient-side

get/v2/project/{project_id}/items/game/group/{external_id}

Получает список игр из указанной группы для построения каталога.

Внимание

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

Примечание

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

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

Example: 44056
external_id
required
string
Default: "all"

Group external ID.

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. Ознакомьтесь со списком стран, поддерживаемых Xsolla, а также с процессом определения страны.

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": [
    ]
}