Xsolla-logo

Lire un objet virtuel par UGSClient-side

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

Récupère des informations sur une objet virtuel par UGS pour la constitution d'un catalogue.

Note

Cet endpoint, accessible sans autorisation, renvoie des données génériques. Cependant, l'autorisation enrichit la réponse avec des détails spécifiques à l'utilisateur pour un résultat personnalisé, tels que les limites disponibles pour l'utilisateur et les promotions.
SecurityXsollaLoginUserJWT
Request
path Parameters
project_id
required
integer

ID de projet. Ce paramètre se trouve dans le Compte éditeur à côté du nom du projet.

Example: 44056
item_sku
required
string

Item SKU.

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

Langue de la réponse. Code de langue à deux lettres minuscules selon la norme ISO 639-1.

country
string

Code pays à deux lettres majuscules selon la norme ISO 3166-1 alpha-2. Consultez la documentation pour obtenir des informations détaillées sur les pays pris en charge par Xsolla et le processus de détermination du pays.

Example: country=US
show_inactive_time_limited_items
integer
Default: 0

Affiche les objets à durée limitée qui ne sont pas disponibles pour l'utilisateur. La période de validité de ces objets n'ayant pas commencé ou ayant déjà expiré.

Example: show_inactive_time_limited_items=1
Responses
200

L'objet virtuel a été reçu avec succès.

404

Objet non trouvé. Assurez-vous que les paramètres project_id et item_sku sont corrects.

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