# Получение списка продаваемых товаров по указанной группе Получает список продаваемых товаров из указанной группы для построения каталога. Внимание Все проекты имеют ограничение на количество товаров, которые вы можете получить в ответе. Значение по умолчанию и максимальное значение — 50 товаров на ответ. Чтобы получить больше данных постранично, используйте поля limit и offset. Примечание Без авторизации метод возвращает общие данные по каталогу товаров. Используйте авторизацию, чтобы получить персонализированные данные пользователя, такие как лимиты и акции, связанные с этим товаром. Для этого необходимо передать JWT пользователя в заголовке Authorization. Подробная информация о JWT пользователя приведена в блоке Безопасность для этого метода. Endpoint: GET /v2/project/{project_id}/items/group/{external_id} Version: 2.0.0 Security: XsollaLoginUserJWT ## Path parameters: - `project_id` (integer, required) ID проекта. Вы можете найти этот параметр в Личном кабинете рядом с названием проекта. Example: 59080 - `external_id` (string, required) External ID группы. ## Query parameters: - `limit` (integer) Лимит количества элементов на странице. Example: 50 - `offset` (integer) Номер элемента, с которого выполняется вывод на странице (нумерация ведется с 0). - `locale` (string) Язык ответа. Двухбуквенный код языка в нижнем регистре по стандарту ISO 639-1 (например, en). Коды локали из пяти символов (например, en-US) поддерживаются в полях локализации (например, name, description), но в ответах приводятся к двухбуквенному формату. Полный список поддерживаемых языков приведен в документации. - `additional_fields[]` (array) Дополнительные поля, которые будут включены в ответ. По умолчанию не возвращаются. Передайте нужные значения, чтобы получить их в ответе. Enum: "media_list", "order", "long_description", "custom_attributes", "item_order_in_group" - `country` (string) Двухбуквенное обозначение страны в верхнем регистре согласно стандарту ISO 3166-1 alpha-2. Ознакомьтесь со списком стран, поддерживаемых Xsolla, а также с процессом определения страны. Example: "US" - `promo_code` (string) Уникальный код, чувствительный к регистру. Содержит буквы и цифры. Example: "WINTER2021" - `show_inactive_time_limited_items` (integer) Отображает предметы с ограниченным сроком действия, которые недоступны пользователю. Срок действия таких предметов еще не начался или уже истек. Example: 1 ## Response 200 fields (application/json): - `has_more` (boolean) Используется как индикатор того, что остались еще страницы. - `items` (array) Example: [{"item_id":259774,"sku":"com.xsolla.electric_shield_1","type":"virtual_good","name":"Electric shield","description":"Electric shield","image_url":"https://cdn3.xsolla.com/img/misc/images/d2d6b1b517e6a7f3765c3bb5a3cfb87d.png","price":{"amount":"9.99","amount_without_discount":"9.99","currency":"USD"},"virtual_prices":[{"description":null,"image_url":"https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png","item_id":259765,"sku":"com.xsolla.gold_1","name":"Gold","type":"virtual_currency","amount":10,"amount_without_discount":10,"calculated_price":{"amount":"10.00","amount_without_discount":"10.00"},"is_default":true},{"description":null,"image_url":"https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png","item_id":259766,"sku":"com.xsolla.silver_1","name":"Silver","type":"virtual_currency","amount":20,"amount_without_discount":20,"calculated_price":{"amount":"20.00","amount_without_discount":"20.00"},"is_default":false},{"description":null,"image_url":"https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png","item_id":259767,"sku":"com.xsolla.bronze_1","name":"Bronze","type":"virtual_currency","amount":200,"amount_without_discount":200,"calculated_price":{"amount":"200.00","amount_without_discount":"200.00"},"is_default":false}],"can_be_bought":true,"promotions":[{"name":"Bonus promotion","date_start":"2020-04-15T16:16:00+03:00","date_end":"2026-04-15T16:16:00+03:00","discount":{"percent":"50.00"},"bonus":[{"quantity":1,"name":"Xsolla Minigun","image_url":"https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png","sku":"com.xsolla.minigun_1","type":"virtual_good"}]}],"attributes":[],"is_free":false,"groups":[{"external_id":"armour","name":"Armour"}],"virtual_item_type":"non_consumable","limits":{"per_user":{"total":5,"available":3,"recurrent_schedule":{"interval_type":"weekly","reset_next_date":1746057600},"limit_exceeded_visibility":"show"}},"vp_rewards":[{"item_id":175232,"sku":"com.xsolla.value_point_1","amount":130,"name":"Value point","image_url":"https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg"},{"item_id":186321,"sku":"clan_value_point_sku_1","amount":50,"name":"Clan Reward VP 1","image_url":"https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg","is_clan":true}]},{"item_id":259775,"sku":"com.xsolla.royal_shield_1","type":"virtual_good","name":"Royal shield","description":"Royal shield","image_url":"https://cdn3.xsolla.com/img/misc/images/ed417975312a52efeeab8b039ff25cb1.png","price":{"amount":"19.99","amount_without_discount":"19.99","currency":"USD"},"virtual_prices":[{"description":null,"image_url":"https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png","item_id":259765,"sku":"com.xsolla.gold_2","name":"Gold","type":"virtual_currency","amount":20,"amount_without_discount":20,"calculated_price":{"amount":"20.00","amount_without_discount":"20.00"},"is_default":true},{"description":null,"image_url":"https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png","item_id":259766,"sku":"com.xsolla.silver_2","name":"Silver","type":"virtual_currency","amount":40,"amount_without_discount":40,"calculated_price":{"amount":"40.00","amount_without_discount":"40.00"},"is_default":false},{"description":null,"image_url":"https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png","item_id":259767,"sku":"com.xsolla.bronze_2","name":"Bronze","type":"virtual_currency","amount":400,"amount_without_discount":400,"calculated_price":{"amount":"400.00","amount_without_discount":"400.00"},"is_default":false}],"can_be_bought":true,"promotions":[],"attributes":[],"is_free":false,"groups":[{"external_id":"armour","name":"Armour"}],"virtual_item_type":"non_consumable","vp_rewards":[]},{"item_id":259776,"sku":"com.xsolla.ancient_helmet_1","type":"virtual_good","name":"Ancient helmet","description":"Ancient helmet","image_url":"https://cdn3.xsolla.com/img/misc/images/e70e16d9626f435e519fc8e1cc1e7176.png","price":{"amount":"1.99","amount_without_discount":"1.99","currency":"USD"},"virtual_prices":[{"description":null,"image_url":"https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png","item_id":259765,"sku":"com.xsolla.gold_3","name":"Gold","type":"virtual_currency","amount":2,"amount_without_discount":2,"calculated_price":{"amount":"2.00","amount_without_discount":"2.00"},"is_default":true},{"description":null,"image_url":"https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png","item_id":259766,"sku":"com.xsolla.silver_3","name":"Silver","type":"virtual_currency","amount":4,"amount_without_discount":4,"calculated_price":{"amount":"4.00","amount_without_discount":"4.00"},"is_default":false},{"description":null,"image_url":"https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png","item_id":259767,"sku":"com.xsolla.bronze_3","name":"Bronze","type":"virtual_currency","amount":40,"amount_without_discount":40,"calculated_price":{"amount":"40.00","amount_without_discount":"40.00"},"is_default":false}],"can_be_bought":true,"promotions":[{"name":"Bonus promotion","date_start":"2020-04-15T16:16:00+03:00","date_end":"2026-04-15T16:16:00+03:00","discount":{"percent":"50.00"},"bonus":[{"quantity":1,"name":"Xsolla Minigun","image_url":"https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png","sku":"com.xsolla.minigun_1","type":"virtual_good"}]}],"attributes":[],"is_free":false,"groups":[{"external_id":"armour","name":"Armour"}],"virtual_item_type":"non_consumable","vp_rewards":[]},{"item_id":259777,"sku":"com.xsolla.wooden_helmet_1","type":"virtual_good","name":"Wooden helmet","description":"Wooden helmet","image_url":"https://cdn3.xsolla.com/img/misc/images/40d2812e52ad9d988ac20fc842fc66f0.png","price":{"amount":"0.99","amount_without_discount":"0.99","currency":"USD"},"virtual_prices":[{"description":null,"image_url":"https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png","item_id":259765,"sku":"com.xsolla.gold_4","name":"Gold","type":"virtual_currency","amount":1,"amount_without_discount":1,"calculated_price":{"amount":"1.00","amount_without_discount":"1.00"},"is_default":true},{"description":null,"image_url":"https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png","item_id":259766,"sku":"com.xsolla.silver_4","name":"Silver","type":"virtual_currency","amount":2,"amount_without_discount":2,"calculated_price":{"amount":"2.00","amount_without_discount":"2.00"},"is_default":false},{"description":null,"image_url":"https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png","item_id":259767,"sku":"com.xsolla.bronze_4","name":"Bronze","type":"virtual_currency","amount":20,"amount_without_discount":20,"calculated_price":{"amount":"20.00","amount_without_discount":"20.00"},"is_default":false}],"can_be_bought":true,"promotions":[],"attributes":[],"is_free":false,"groups":[{"external_id":"armour","name":"Armour"}],"virtual_item_type":"non_consumable","vp_rewards":[]}] - `items.item_id` (integer) Внутренний уникальный ID товара, который задается при создании товара. Example: 259774 - `items.sku` (string) Уникальный ID товара. Артикул может содержать только строчные и заглавные латинские буквы, цифры, точки, тире и подчеркивания. Example: "com.xsolla.electric_shield_1" - `items.name` (string) Название товара. Example: "Electric shield" - `items.groups` (array) Группы, к которым принадлежит товар. - `items.groups.external_id` (string) [Внешний ID группы товаров](/ru/api/catalog/item-groups-admin/admin-create-item-group#item-groups-admin/admin-create-item-group/t=request&path=external_id), который был указан при создании. Example: "exclusive" - `items.groups.name` (string) Название группы. Example: "Exclusive" - `items.groups.item_order_in_group` (integer) Позиция предмета внутри группы, определяющая порядок отображения. Возвращается в ответ только при указании в запросе query-параметра additional_fields[]. Example: 1 - `items.attributes` (array) Список атрибутов и их значений, соответствующих товару. Может использоваться для фильтрации каталога. - `items.attributes.external_id` (string) Уникальный ID атрибута. external_id может содержать только строчные и заглавные латинские буквы, цифры, тире и подчеркивания. - `items.attributes.name` (object) Название атрибута. Example: "Genre" - `items.attributes.values` (array) - `items.attributes.values.external_id` (string) Уникальный ID значения атрибута. external_id может содержать только строчные латинские буквы, цифры, тире и подчеркивания. - `items.attributes.values.value` (string) Значение атрибута. Example: "Strategy" - `items.type` (string) Тип товара: virtual_good/virtual_currency/bundle/game_key/physical_good. Enum: "virtual_good", "virtual_currency", "bundle", "game_key", "physical_good" - `items.description` (string,null) Описание товара. Example: "Electric shield" - `items.image_url` (string) URL-адрес изображения. Example: "https://cdn3.xsolla.com/img/misc/images/d2d6b1b517e6a7f3765c3bb5a3cfb87d.png" - `items.is_free` (boolean) Является ли товар бесплатным. - `items.price` (object) Цены на товар. - `items.price.amount` (string) Цена товара со скидкой. Example: "9.99" - `items.price.amount_without_discount` (string) Цена товара. Example: "9.99" - `items.price.currency` (string) Валюта, в которой указана цена товара. Трехбуквенный код в соответствии со стандартом [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). Example: "USD" - `items.virtual_prices` (array) Виртуальные цены. - `items.virtual_prices.amount` (integer) Цена товара в виртуальной валюте. Example: 100 - `items.virtual_prices.amount_without_discount` (integer) Цена товара в виртуальной валюте без скидки. Всегда равна значению amount, так как скидки не применяются к ценам в виртуальной валюте. Example: 200 - `items.virtual_prices.calculated_price` (object) - `items.virtual_prices.calculated_price.amount` (string) - `items.virtual_prices.calculated_price.amount_without_discount` (string) - `items.virtual_prices.sku` (string) Артикул виртуальной валюты. Example: "vc_gold" - `items.virtual_prices.is_default` (boolean) Является ли ценой в виртуальной валюте по умолчанию. Example: true - `items.virtual_prices.image_url` (string,null) URL-адрес изображения виртуальной валюты. Example: "http://image.png" - `items.virtual_prices.item_id` (integer) Уникальный ID товара, назначенный Xsolla. Example: 259774 - `items.virtual_prices.name` (string) Название виртуальной валюты. Example: "Gold" - `items.virtual_prices.type` (string) Тип товара. Для виртуальной валюты имеет значение `virtual_currency. Example: "virtual_currency" - `items.virtual_prices.description` (string,null) Описание виртуальной валюты. Example: "In-game currency used to purchase weapons and upgrades" - `items.virtual_item_type` (string) Тип виртуального предмета. Возможные значения: - consumable — предмет, исчезающий из инвентаря после использования (например, патроны). - non_consumable — предмет, остающийся в инвентаре в течение неограниченного времени. - non_renewing_subscription — предмет с ограниченным сроком действия, который может служить представлением доступа к сервисам или контенту в течение ограниченного периода времени. Enum: "consumable", "non_consumable", "non_renewing_subscription" - `items.can_be_bought` (boolean) Если true, пользователь может купить товар. Example: true - `items.promotions` (array) Примененные акции для отдельных товаров в корзине. Массив возвращается, если: * Скидочная акция настроена для отдельного товара. * Используется промокод с настройкой Скидка на выбранные товары. Если акции на уровне отдельных товаров не применялись, возвращается пустой массив. - `items.promotions.name` (string) - `items.promotions.date_start` (string,null) - `items.promotions.date_end` (string,null) - `items.promotions.discount` (object,null) - `items.promotions.discount.percent` (string,null) - `items.promotions.discount.value` (string,null) - `items.promotions.bonus` (array) - `items.promotions.bonus.sku` (string) - `items.promotions.bonus.quantity` (integer) - `items.promotions.bonus.type` (string) Тип бонусного товара. Enum: "virtual_good", "virtual_currency", "bundle", "physical_good", "game_key", "nft" - `items.promotions.bonus.name` (string) Название бонусного товара. Недоступно для типа бонусного товара physical_good. - `items.promotions.bonus.image_url` (string) URL-адрес изображения бонусного бандла. Недоступно для типа бонусного товара physical_good. - `items.promotions.bonus.bundle_type` (string) Тип товара бонусного бандла. Доступно только для бонусного товара типа bundle. Enum: "standard", "virtual_currency_package" - `items.promotions.limits` (object) - `items.promotions.limits.per_user` (object) - `items.promotions.limits.per_user.available` (integer) - `items.promotions.limits.per_user.total` (integer) - `items.limits` (object,null) Ограничения на продажу товара. - `items.limits.per_user` (object,null) Ограничения на продажу товара для пользователя. - `items.limits.per_user.total` (integer) Максимальное количество товара, которое может приобрести один пользователь. Example: 5 - `items.limits.per_user.available` (integer) Оставшееся количество товара, которое может приобрести текущий пользователь. Example: 3 - `items.limits.per_user.recurrent_schedule` (any) - `items.limits.per_user.limit_exceeded_visibility` (string) Определяет видимость товара в каталоге после достижения лимита покупок до момента следующего обновления лимитов. Применяется к товарам, для которых задано регулярное обновление лимитов в массиве recurrent_schedule. Если обновление лимитов не задано, товар не отображается в каталоге после достижения лимита независимо от значения limit_exceeded_visibility. Возможные значения: - show — Товар возвращается в методах получения каталога товаров после достижения лимита покупок. В клиентских методах получения каталога после достижения лимита товар возвращается с флагом can_be_bought: false. Дата следующего сброса возвращается в reset_next_date. - hide — Товар не возвращается в методах получения каталога товаров после достижения лимита покупок до момента сброса лимитов. Enum: "show", "hide" - `items.limits.per_item` (object,null) Ограничения на продажу для конкретного товара. - `items.limits.per_item.total` (integer) Максимальное количество товара, которое могут приобрести все пользователи. Example: 5 - `items.limits.per_item.available` (integer) Оставшееся количество товара, которое могут приобрести все пользователи. Example: 3 - `items.custom_attributes` (object) JSON-объект, содержащий атрибуты товара и их значения. - `items.vp_rewards` (array) Список призовых баллов для товара. - `items.vp_rewards.item_id` (integer) Внутренний уникальный ID виртуального предмета или валюты. - `items.vp_rewards.sku` (string) Уникальный ID призовых баллов. - `items.vp_rewards.amount` (integer) Количество призовых баллов. - `items.vp_rewards.name` (string) Название призовых баллов. - `items.vp_rewards.is_clan` (boolean) Может ли призовой балл использоваться в цепочках наград для клана. - `items.loyalty_rewards` (array) Баллы лояльности, которые пользователь получает в награду за покупку товара. - `items.loyalty_rewards.name` (string) Название баллов лояльности. - `items.loyalty_rewards.sku` (string) Артикул балла лояльности. Используйте это значение в параметре loyalty_point_sku в других запросах API, например при создании заказа, оплачиваемого баллами лояльности. - `items.loyalty_rewards.description` (string) Описание баллов лояльности. - `items.loyalty_rewards.amount` (integer) Количество баллов лояльности, которое пользователь получает за покупку товара. - `items.loyalty_prices` (array) Баллы лояльности, за которые можно купить товар. - `items.loyalty_prices.amount` (integer) Цена товара в указанных баллах лояльности. ## Response 404 fields (application/json): - `statusCode` (integer) Код HTTP-статуса ответа. Example: 404 - `errorCode` (integer) Код ошибки Xsolla Example: 4403 - `errorMessage` (string) Краткое описание ошибки. Example: "[0401-4403]: Item group not found"