Lire un objet virtuel par UGSClient-side
Récupère des informations sur un objet virtuel par son UGS pour la constitution d'un catalogue.
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 et les promotions disponibles pour l'utilisateur.
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 UGS de l'objet. 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 |
L'objet virtuel a été reçu avec succès.
Objet non trouvé. Assurez-vous que les paramètres project_id et item_sku sont corrects.
- curl
- JavaScript
- Node.js
- Python
- C#
- Go
- Java
curl -i -X GET \ 'https://store.xsolla.com/api/v2/project/{project_id}/items/virtual_items/sku/{item_sku}?locale=en&country=US&show_inactive_time_limited_items=1' \ -H 'Authorization: Bearer <YOUR_JWT_HERE>'
- 200
- 404
{- "attributes": [
- {
- "external_id": "attr_1",
- "name": {
- "en-US": "OK"
}, - "values": [
- {
- "external_id": "val1",
- "value": "VALUE"
}, - {
- "external_id": "val2",
- "value": "VALUE2"
}
]
}
], - "can_be_bought": true,
- "custom_attributes": {
- "attr": "value",
- "purchased": 0
}, - "description": {
- "en": "Honshu Boshin Wakizashi - Modern Tactical Samurai / Ninja Sword - Hand Forged 1060 Carbon Steel - Full Tang, Fully Functional, Battle Ready - Black TPR, Steel Guard and Pommel"
}, - "groups": [
- {
- "external_id": "weapons",
- "name": {
- "en": "weapons"
}
}
], - "inventory_options": {
- "consumable": null,
- "expiration_period": null
}, - "is_free": false,
- "item_id": 488833,
- "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"
}
}
}, - "name": {
- "en": "Sword Xsolla Skin"
}, - "periods": [
- {
- "date_from": "2020-08-11T10:00:00+03:00",
- "date_until": "2020-08-11T20:00:00+03:00"
}
], - "price": {
- "amount": "4.99",
- "amount_without_discount": "4.99",
- "currency": "USD"
}, - "promotions": [ ],
- "sku": "com.xsolla.swords_1",
- "type": "virtual_good",
- "virtual_item_type": "non_consumable",
- "virtual_prices": [ ],
- "vp_rewards": [ ]
}