Xsolla-logo

Получение виртуального предмета по артикулуClient-side

get/v2/project/{project_id}/items/virtual_items/sku/{item_sku}

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

Примечание

Без авторизации метод возвращает общие данные. Используйте авторизацию, чтобы получить персонализированные данные пользователя, такие как лимиты и акции.
SecurityXsollaLoginUserJWT
Request
path Parameters
project_id
required
integer

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

Example: 44056
item_sku
required
string

Артикул товара.

Example: booster_mega_1
query Parameters
locale
string
Default: "en"

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

country
string

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

Примечание

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

Example: country=US
show_inactive_time_limited_items
integer
Default: 0

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

Example: show_inactive_time_limited_items=1
Responses
200

Виртуальный товар был успешно получен.

404

Товар не найден. Убедитесь, что верно указали project_id и item_sku.

Request samples
Response samples
application/json
{
  • "attributes": [
    ],
  • "can_be_bought": true,
  • "custom_attributes": {
    },
  • "description": {
    },
  • "groups": [
    ],
  • "inventory_options": {
    },
  • "is_free": false,
  • "item_id": 488833,
  • "limits": {
    },
  • "name": {
    },
  • "periods": [
    ],
  • "price": {
    },
  • "promotions": [ ],
  • "sku": "swords_1",
  • "type": "virtual_good",
  • "virtual_item_type": "non_consumable",
  • "virtual_prices": [ ],
  • "vp_rewards": [ ]
}