Получение списка пакетов виртуальной валюты

Внимание

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

Примечание

В целом, использование каталога товаров доступно без авторизации.
Только авторизованные пользователи могут получать персонализированный каталог.

SecurityXsollaLoginUserJWT

Request

path Parameters

project_id

required

integer

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

Example: 44056

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": [{"attributes": [ ],
"bundle_type": "virtual_currency_package",
"can_be_bought": true,
"content": [{"description": "Big Rocket - short description",
"image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png",
"inventory_options": {"consumable": {"usages_count": 1
},
"expiration_period": null
},
"name": "Big Rocket",
"quantity": 100,
"sku": "big_rocket",
"type": "virtual_currency"
}
],
"custom_attributes": {"attr": "value",
"purchased": 0
},
"description": "VC Short Package Description",
"groups": [ ],
"image_url": "http://vc_package_image.png",
"is_free": false,
"limits": {"per_user": {"available": 3,
"recurrent_schedule": {"interval_type": "weekly",
"reset_next_date": 1746057600
},
"total": 5
}
},
"name": "VC Name first package",
"periods": [{"date_from": "2020-08-11T10:00:00+03:00",
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"price": {"amount": "2.0000",
"amount_without_discount": "2.0000",
"currency": "USD"
},
"promotions": [{"bonus": [{"image_url": "https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png",
"name": "Xsolla Minigun",
"quantity": 1,
"sku": "minigun_1",
"type": "virtual_good"
}
],
"date_end": "2026-04-15T16:16:00+03:00",
"date_start": "2020-04-15T16:16:00+03:00",
"discount": {"percent": "50.00"
},
"name": "Bonus promotion"
}
],
"sku": "vc_package_1",
"type": "bundle",
"virtual_prices": [ ],
"vp_rewards": [ ]
},
{"attributes": [ ],
"bundle_type": "virtual_currency_package",
"can_be_bought": true,
"content": [{"description": "description",
"image_url": "http://image.png",
"inventory_options": {"consumable": {"usages_count": 1
},
"expiration_period": null
},
"name": "SHOTGUN FOR TRUE RAIDERS",
"quantity": 200,
"sku": "shotgun_raider",
"type": "virtual_currency"
}
],
"description": "VC Short Package Description",
"groups": [ ],
"image_url": "http://vc_package_image.png",
"is_free": false,
"limits": {"per_user": {"available": 3,
"recurrent_schedule": {"interval_type": "weekly",
"reset_next_date": 1746057600
},
"total": 5
}
},
"name": "VC Name third package",
"periods": [{"date_from": null,
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"price": {"amount": "4.0000",
"amount_without_discount": "4.0000",
"currency": "USD"
},
"promotions": [{"bonus": [{"image_url": "https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png",
"name": "Xsolla Minigun",
"quantity": 1,
"sku": "minigun_1",
"type": "virtual_good"
}
],
"date_end": "2026-04-15T16:16:00+03:00",
"date_start": "2020-04-15T16:16:00+03:00",
"discount": {"percent": "50.00"
},
"name": "Bonus promotion"
}
],
"sku": "vc_package_3",
"type": "bundle",
"virtual_prices": [ ],
"vp_rewards": [ ]
}
]
}