Lire la liste des objets virtuels pour administration

get/v2/project/{project_id}/admin/items/virtual_items

Récupère la liste des objets virtuels au sein d'un projet à des fins d'administration.

Note

N'utilisez pas cet endpoint pour créer un catalogue de magasin.

SecuritybasicAuth

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

query Parameters

limit	integer Nombre maximal d'éléments sur une page. Example: limit=50
offset	integer Numéro de l'élément à partir duquel la liste est générée (le décompte commence à 0). Example: offset=0
promo_code	string [ 1 .. 128 ] characters Code unique sensible à la casse. Comprend des lettres et des chiffres. Example: promo_code=WINTER2021

Responses

200

La liste d'objets virtuels a été reçue avec succès.

401

L'authentification de base n'a pas été passée ou est incorrecte. Vérifiez que vous avez utilisé l'authentification de base ou des informations d'identification correctes.

Request samples

Response samples

application/json

{"items": [{"attributes": [{"external_id": "attr_1",
"name": {"en-US": "OK"
},
"values": [{"external_id": "val1",
"value": {"en-US": "VALUE"
}
},
{"external_id": "val2",
"value": {"en-US": "VALUE2"
}
}
]
}
],
"custom_attributes": {"attr": "value",
"purchased": 0
},
"description": {"en": "Suit up with flair showcasing your allegiance to Xsolla"
},
"groups": [{"external_id": "featured",
"name": {"en": "featured"
}
},
{"external_id": "Xsolla",
"name": {"en": "Xsolla"
}
},
{"external_id": "Premium",
"name": {"en": "Premium"
}
},
{"external_id": "NonConsumableGroupCode",
"name": {"en": "Non-consumable"
}
}
],
"image_url": "https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png",
"inventory_options": {"consumable": false,
"expiration_period": null
},
"is_enabled": true,
"is_free": false,
"is_show_in_store": true,
"limits": {"per_item": null,
"per_user": null,
"recurrent_schedule": null
},
"long_description": {"en": "The metal coverings formerly worn by soldiers or warriors to protect the body in battle."
},
"media_list": [ ],
"name": {"en": "Maximum Armor Xsolla  Skin"
},
"order": 1,
"periods": [ ],
"prices": [{"amount": 12.99,
"currency": "USD",
"is_default": true,
"is_enabled": true
},
{"amount": 20.99,
"country_iso": "CZ",
"currency": "CZK",
"is_default": false,
"is_enabled": true
}
],
"regions": [ ],
"sku": "armor_max_1",
"type": "virtual_good",
"vc_prices": [ ]
},
{"attributes": [ ],
"description": {"en": "Defend your Empire against Xsolla with the max armor"
},
"groups": [{"children": [ ],
"description": {"en": "Equipment"
},
"external_id": "all",
"id": 10,
"image_url": null,
"is_enabled": true,
"level": 0,
"name": {"en": "Equipment"
},
"order": 1,
"parent_external_id": null,
"parent_group_id": null
},
{"children": [ ],
"description": {"en": "equipment"
},
"external_id": "equipment",
"id": 14,
"image_url": null,
"is_enabled": false,
"level": 0,
"name": {"en": "Nice Equipment"
},
"order": 1,
"parent_external_id": null,
"parent_group_id": null
},
{"children": [ ],
"description": {"en": "1"
},
"external_id": "Empire",
"id": 17,
"image_url": null,
"is_enabled": false,
"level": 0,
"name": {"en": "Empire"
},
"order": 1,
"parent_external_id": null,
"parent_group_id": null
}
],
"image_url": "https://cdn.xsolla.net/img/misc/images/67d647ad4f4e9a905bd552b0408db8a8.png",
"inventory_options": {"consumable": true,
"expiration_period": null
},
"is_enabled": true,
"is_free": false,
"is_show_in_store": true,
"limits": {"per_item": null,
"per_user": {"total": 5
},
"recurrent_schedule": {"per_user": {"day_of_month": null,
"day_of_week": null,
"displayable_reset_next_date": "2023-02-28T11:00:00+08:00",
"displayable_reset_start_date": "2023-02-28T11:00:00+08:00",
"interval_type": "daily",
"reset_next_date": 1677553200,
"time": "11:00:00+08:00"
}
}
},
"long_description": "merchant_virtual_items_virtual_item_long_description_160310",
"media_list": [ ],
"name": {"en": "Empire Maximum Armor"
},
"order": 1,
"periods": [{"date_from": "2020-08-11T10:00:00+03:00",
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"prices": [{"amount": 12.99,
"currency": "USD",
"is_default": true,
"is_enabled": true
},
{"amount": 20.99,
"country_iso": "CZ",
"currency": "CZK",
"is_default": false,
"is_enabled": true
}
],
"regions": [ ],
"sku": "armor_max_2",
"type": "virtual_good",
"vc_prices": [ ]
},
{"attributes": [ ],
"description": {"en": "Moderately protect yourself against the Empires barrage of attacks"
},
"groups": [{"children": [ ],
"description": {"en": "Equipment"
},
"external_id": "all",
"id": 10,
"image_url": null,
"is_enabled": true,
"level": 0,
"name": {"en": "Equipment"
},
"order": 1,
"parent_external_id": null,
"parent_group_id": null
},
{"children": [ ],
"description": {"en": "Xsolla"
},
"external_id": "Xsolla",
"id": 12,
"image_url": null,
"is_enabled": false,
"level": 0,
"name": {"en": "Xsolla"
},
"order": 1,
"parent_external_id": null,
"parent_group_id": null
},
{"children": [ ],
"description": {"en": "equipment"
},
"external_id": "equipment",
"id": 14,
"image_url": null,
"is_enabled": false,
"level": 0,
"name": {"en": "Nice Equipment"
},
"order": 1,
"parent_external_id": null,
"parent_group_id": null
}
],
"image_url": "https://cdn.xsolla.net/img/misc/images/7f6e216f8fcc3c1796162897c2b0db01.png",
"inventory_options": {"consumable": true,
"expiration_period": null
},
"is_enabled": true,
"is_free": false,
"is_show_in_store": false,
"limits": {"per_item": null,
"per_user": {"total": 5
},
"recurrent_schedule": {"per_user": {"day_of_month": null,
"day_of_week": null,
"displayable_reset_next_date": "2023-02-28T11:00:00+08:00",
"displayable_reset_start_date": "2023-02-28T11:00:00+08:00",
"interval_type": "daily",
"reset_next_date": 1677553200,
"time": "11:00:00+08:00"
}
}
},
"long_description": {"en": "Armor is a security-as-a-service company that provides cloud security and compliance solutions for small businesses and enterprises."
},
"media_list": [ ],
"name": {"en": "Xsolla Medium Armor"
},
"order": 1,
"periods": [{"date_from": null,
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"prices": [{"amount": 4.99,
"currency": "USD",
"is_default": true,
"is_enabled": true
},
{"amount": 20.99,
"country_iso": "CZ",
"currency": "CZK",
"is_default": false,
"is_enabled": true
}
],
"regions": [ ],
"sku": "armor_med_1",
"type": "virtual_good",
"vc_prices": [ ]
},
{"attributes": [{"external_id": "attr_1",
"name": {"en-US": "OK"
},
"values": [{"external_id": "val1",
"value": {"en-US": "VALUE"
}
},
{"external_id": "val2",
"value": {"en-US": "VALUE2"
}
}
]
}
],
"description": {"en": "Moderately protect yourself against Xsolla's barrage of attacks"
},
"groups": [{"children": [ ],
"description": {"en": "Equipment"
},
"external_id": "all",
"id": 10,
"image_url": null,
"is_enabled": true,
"level": 0,
"name": {"en": "Equipment"
},
"order": 1,
"parent_external_id": null,
"parent_group_id": null
},
{"children": [ ],
"description": {"en": "equipment"
},
"external_id": "equipment",
"id": 14,
"image_url": null,
"is_enabled": false,
"level": 0,
"name": {"en": "Nice Equipment"
},
"order": 1,
"parent_external_id": null,
"parent_group_id": null
},
{"children": [ ],
"description": {"en": "1"
},
"external_id": "Empire",
"id": 17,
"image_url": null,
"is_enabled": false,
"level": 0,
"name": {"en": "Empire"
},
"order": 1,
"parent_external_id": null,
"parent_group_id": null
}
],
"image_url": "https://cdn.xsolla.net/img/misc/images/737b4c93205dc774f47dda1f73037734.png",
"inventory_options": {"consumable": true,
"expiration_period": null
},
"is_enabled": true,
"is_free": false,
"is_show_in_store": true,
"limits": {"per_item": {"available": 455,
"reserved": 5,
"sold": 40,
"total": 500
},
"per_user": {"total": 5
},
"recurrent_schedule": {"per_user": {"day_of_month": null,
"day_of_week": null,
"displayable_reset_next_date": "2023-02-28T11:00:00+08:00",
"displayable_reset_start_date": "2023-02-28T11:00:00+08:00",
"interval_type": "daily",
"reset_next_date": 1677553200,
"time": "11:00:00+08:00"
}
}
},
"long_description": "merchant_virtual_items_virtual_item_long_description_160311",
"media_list": [ ],
"name": {"en": "Empire Medium Armor"
},
"order": 1,
"periods": [ ],
"prices": [{"amount": 4.99,
"currency": "USD",
"is_default": true,
"is_enabled": true
},
{"amount": 20.99,
"currency": "CZK",
"is_default": false,
"is_enabled": true
}
],
"regions": [ ],
"sku": "armor_med_2",
"type": "virtual_good",
"vc_prices": [ ]
}
]
}