获取用于构建目录的虚拟物品列表。
limit | integer 页面上元素数量的限制。 Example: limit=50 |
offset | integer 元素编号,从该元素开始生成列表(从0开始数)。 Example: offset=0 |
locale | string Default: "en" 响应语言。按照ISO 639-1规定使用两个小写字母的语言代码。 |
additional_fields[] | Array of strings 附加字段列表。如果在请求中发送这些字段,则它们将包含在响应中。可用字段 |
country | string 符合ISO 3166-1 alpha-2标准的两个大写字母的国家/地区代码。如果在创建商品时进行了指定,则显示目录的区域价格和限制。 注意
如果没有明确指定国家/地区,则会根据用户的IP地址设置。 Example: country=US |
已成功收到虚拟物品列表。
{- "items": [
- {
- "attributes": [
- {
- "external_id": "stack_size",
- "name": "Stack size",
- "values": [
- {
- "external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85",
- "value": "5"
}
]
}
], - "can_be_bought": true,
- "description": "Big Rocket - description",
- "groups": [
- {
- "external_id": "accessory",
- "name": "Accessory"
}
], - "inventory_options": {
- "consumable": {
- "usages_count": 1
}, - "expiration_period": {
- "type": "day",
- "value": 1
}
}, - "is_free": false,
- "limits": {
- "$ref": "../examples/Catalog_item_limits.yaml"
}, - "name": "Big Rocket",
- "periods": [
- {
- "date_from": "2020-08-11T10:00:00+03:00",
- "date_until": "2020-08-11T20:00:00+03:00"
}
], - "price": {
- "amount": "100.99",
- "amount_without_discount": "100.99",
- "currency": "USD"
}, - "promotions": [
- {
- "bonus": [
- {
- "name": "Xsolla Minigun",
- "quantity": 1,
- "sku": "minigun_1",
- "type": "virtual_good"
}, - {
- "quantity": 1,
- "sku": "phys_good_1",
- "type": "physical_good"
}, - {
- "bundle_type": "standard",
- "name": "Super Lootbox with items",
- "quantity": 1,
- "sku": "SuperLootboxBundle_1",
- "type": "bundle"
}
], - "date_end": "2026-04-15T16:16:00+03:00",
- "date_start": "2020-04-15T16:16:00+03:00",
- "discount": "null,",
- "name": "Bonus promotion"
}
], - "sku": "big_rocket",
- "type": "virtual_good",
- "virtual_item_type": "non_renewing_subscription",
- "virtual_prices": [
- {
- "amount": 100,
- "amount_without_discount": 100,
- "description": "description",
- "is_default": true,
- "name": "SHOTGUN FOR TRUE RAIDERS",
- "sku": "vc_test",
- "type": "virtual_currency"
}
]
}, - {
- "attributes": [
- {
- "external_id": "stack_size",
- "name": "Stack size",
- "values": [
- {
- "external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85",
- "value": "5"
}
]
}, - {
- "external_id": "rating",
- "name": "Rating",
- "values": [
- {
- "external_id": "rating_e3364991f92e751689a68b96598a5a5a84010b85",
- "value": "3.9"
}
]
}
], - "can_be_bought": true,
- "description": "description",
- "groups": [
- {
- "external_id": "hair",
- "name": "Hair"
}
], - "inventory_options": [
- {
- "consumable": [
- {
- "usages_count": 1
}
]
}, - {
- "expiration_period": [
- {
- "type": "day"
}, - {
- "value": 1
}
]
}
], - "is_free": false,
- "limits": null,
- "name": "SHOTGUN FOR TRUE RAIDERS",
- "periods": [
- {
- "date_from": null,
- "date_until": "2020-08-11T20:00:00+03:00"
}
], - "price": {
- "amount": "101.0",
- "amount_without_discount": "101.0",
- "currency": "USD"
}, - "promotions": [ ],
- "sku": "shotgun_raider",
- "type": "virtual_good",
- "virtual_item_type": "non_renewing_subscription",
- "virtual_prices": [
- {
- "amount": 100,
- "amount_without_discount": 100,
- "description": "description",
- "is_default": true,
- "name": "SHOTGUN FOR TRUE RAIDERS",
- "sku": "vc_test",
- "type": "virtual_currency"
}, - {
- "amount": 200,
- "amount_without_discount": 200,
- "description": "description",
- "is_default": false,
- "name": "SHOTGUN FOR TRUE RAIDERS",
- "sku": "vc_test_2",
- "type": "virtual_currency"
}
]
}, - {
- "attributes": [ ],
- "can_be_bought": true,
- "description": "description",
- "groups": [ ],
- "inventory_options": {
- "consumable": {
- "usages_count": 1
}, - "expiration_period": {
- "type": "day",
- "value": 1
}
}, - "is_free": true,
- "limits": null,
- "name": "SHOTGUN FOR TRUE RAIDERS",
- "periods": [ ],
- "price": null,
- "promotions": [ ],
- "sku": "shotgun_raider_2",
- "type": "virtual_good",
- "virtual_item_type": "non_renewing_subscription",
- "virtual_prices": [ ]
}
]
}