Obter lista de itens virtuais

Atenção

Todos os projetos têm uma limitação no número de itens que você pode obter na resposta. O valor padrão e máximo é de 50 itens por resposta. Para obter mais dados página por página, use os campos limit e offset.

Observação

Em geral, o uso de catálogo de itens está disponível sem autorização.
Somente usuários autorizados podem obter um catálogo personalizado.

SecurityXsollaLoginUserJWT

Request

path Parameters

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

query Parameters

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 A lista de campos adicionais. Esses campos estarão na resposta se você enviá-los em sua solicitação. Items Enum: "media_list" "order" "long_description" "custom_attributes"
country	string Código de país maiúsculo de duas letras de acordo com o padrão ISO 3166-1 alpha-2. Mostra os preços regionais e as restrições de um catálogo se eles foram especificados durante a criação de um item. Observação Se você não especificar o país explicitamente, ele será definido com base no endereço IP do usuário. 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

Responses

200

A lista de itens virtuais foi recebida com sucesso.

Request samples

Response samples

application/json

{"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"
}
}
],
"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": {"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": [{"image_url": "https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png",
"name": "Xsolla Minigun",
"quantity": 1,
"sku": "minigun_1",
"type": "virtual_good"
},
{"quantity": 1,
"sku": "phys_good_1",
"type": "physical_good"
},
{"bundle_type": "standard",
"image_url": "https://cdn.xsolla.net/img/misc/images/9676f06265375087e607cb79c5283688.png",
"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",
"image_url": "http://image.png",
"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"
}
}
],
"image_url": "http://image.png",
"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",
"image_url": "http://image.png",
"is_default": true,
"name": "SHOTGUN FOR TRUE RAIDERS",
"sku": "vc_test",
"type": "virtual_currency"
},
{"amount": 200,
"amount_without_discount": 200,
"description": "description",
"image_url": "http://image.png",
"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": [ ],
"image_url": "http://image.png",
"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": [ ]
}
]
}