Lire une monnaie virtuelle par UGSClient-side
get/v2/project/{project_id}/items/virtual_currency/sku/{virtual_currency_sku}
Gets a virtual currency by SKU for building a catalog.
Note
This endpoint, accessible without authorization, returns generic data. However, authorization enriches the response with user-specific details for a personalized result, such as available user limits and promotions.
This endpoint, accessible without authorization, returns generic data. However, authorization enriches the response with user-specific details for a personalized result, such as available user limits and 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 |
| virtual_currency_sku required | string UGS de la monnaie virtuelle. Example: crystal |
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 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 |
| 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
La monnaie virtuelle a été reçue avec succès.
Request samples
- curl
- JavaScript
- Node.js
- Python
- C#
- Go
- Java
curl -i -X GET \ 'https://store.xsolla.com/api/v2/project/{project_id}/items/virtual_currency/sku/{virtual_currency_sku}?locale=en&country=US&show_inactive_time_limited_items=1' \ -H 'Authorization: Bearer <YOUR_JWT_HERE>'
Response samples
- 200
application/json
{- "attributes": [
- {
- "external_id": "attr1",
- "name": {
- "en-US": "Attribute"
}, - "values": [
- {
- "external_id": "val1",
- "value": "Value"
}, - {
- "external_id": "val2",
- "value": "Value"
}
]
}
], - "can_be_bought": true,
- "custom_attributes": {
- "attr": "value",
- "purchased": 0
}, - "description": "Crystals - short description",
- "groups": [ ],
- "inventory_options": {
- "consumable": {
- "usages_count": 1
}, - "expiration_period": null
}, - "is_free": false,
- "item_id": 451414,
- "limits": null,
- "name": "Crystals",
- "periods": [
- {
- "date_from": "2023-08-11T10:00:00+03:00",
- "date_until": "2023-08-11T20:00:00+03:00"
}
], - "price": {
- "amount": "100",
- "amount_without_discount": "100",
- "currency": "USD"
}, - "promotions": [ ],
- "sku": "com.xsolla.crystal_1",
- "type": "virtual_currency",
- "virtual_prices": [ ]
}