Obtém uma lista de itens virtuais para criar um catálogo.
project_id required | integer ID do projeto. Você pode encontrar esse parâmetro em sua Conta de Distribuidor ao lado do nome do projeto. Example: 44056 |
limit | integer Limite da quantidade de elementos na página. Example: limit=50 |
offset | integer Número do elemento a partir do qual a lista é gerada (a quantidade começa a partir de 0). Example: offset=0 |
locale | string Default: "en" Linguagem de resposta. Código de idioma minúsculo de duas letras de acordo com o padrão ISO 639-1. |
additional_fields[] | Array of strings The list of additional fields. These fields will be in the response if you send them in your request. |
country | string Two-letter uppercase country code per ISO 3166-1 alpha-2. Check the documentation for detailed information about countries supported by Xsolla and the process of determining the country. Example: country=US |
promo_code | string [ 1 .. 128 ] characters Código exclusivo que diferencia maiúsculas de minúsculas. Contém letras e números. Example: promo_code=WINTER2021 |
show_inactive_time_limited_items | integer Default: 0 Exibe itens de tempo limitado que não estão disponíveis para o usuário. O prazo de validade desses itens não começou ou já expirou. Example: show_inactive_time_limited_items=1 |
A lista de itens virtuais foi recebida com sucesso.
{- "has_more": true,
- "items": [
- {
- "attributes": [
- {
- "external_id": "stack_size",
- "name": "Stack size",
- "values": [
- {
- "external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85",
- "value": "5"
}
]
}
], - "can_be_bought": true,
- "custom_attributes": {
- "attr": "value",
- "purchased": 0
}, - "description": "Big Rocket - description",
- "groups": [
- {
- "external_id": "accessory",
- "name": {
- "en": "accessory"
}
}
], - "inventory_options": {
- "consumable": {
- "usages_count": 1
}, - "expiration_period": {
- "type": "day",
- "value": 1
}
}, - "is_free": false,
- "limits": {
- "per_user": {
- "available": 3,
- "recurrent_schedule": {
- "interval_type": "weekly",
- "reset_next_date": 1746057600
}, - "total": 5
}
}, - "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"
}
], - "vp_rewards": [ ]
}, - {
- "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": {
- "en": "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"
}
], - "vp_rewards": [ ]
}, - {
- "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": [ ],
- "vp_rewards": [ ]
}
]
}