Obter item virtual por SKUClient-side
get/v2/project/{project_id}/items/virtual_items/sku/{item_sku}
Gets a virtual item 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 do projeto. Você pode encontrar esse parâmetro em sua Conta de Distribuidor ao lado do nome do projeto. Example: 44056 |
| item_sku required | string SKU do item. Example: booster_mega_1 |
query Parameters
| 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. |
| 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 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
O item virtual foi recebido com sucesso.
404
O item não foi encontrado. Certifique-se de que o project_id e o item_sku estão corretos.
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_items/sku/{item_sku}?locale=en&country=US&show_inactive_time_limited_items=1' \ -H 'Authorization: Bearer <YOUR_JWT_HERE>'
Response samples
- 200
- 404
application/json
{- "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": [ ]
}