Xsolla-logo
  • 文档
  • 创建帐户

按SKU获取虚拟物品Client-side

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

按SKU获取用于构建目录的虚拟物品。

注:

此端点无需授权即可访问,返回通用数据。但是授权后可以通过用户详细信息来丰富响应,获得个性化结果,例如适用的用户限制和促销活动等。
SecurityXsollaLoginUserJWT
Request
path Parameters
project_id
required
integer

项目编号。您可以在您的发布商帐户项目名称旁边。

Example: 44056
item_sku
required
string

商品SKU。

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