Obtener artículo virtual por SKUClient-side
Obtiene un artículo virtual por SKU para crear un catálogo.
Este punto final, accesible sin autorización, devuelve datos genéricos. Sin embargo, la autorización enriquece la respuesta con detalles específicos del usuario para un resultado personalizado, como los límites de usuario y las promociones disponibles.
path Parameters
| project_id required | integer ID del proyecto. Encontrará este parámetro en su Cuenta del editor junto al nombre del proyecto. Example: 44056 |
| item_sku required | string SKU del artículo. Example: booster_mega_1 |
query Parameters
| locale | string Default: "en" Idioma de respuesta. Código de idioma de dos letras minúsculas según la norma ISO 639-1. |
| country | string Código de país de dos letras mayúsculas de conformidad con la norma ISO 3166-1 alpha-2. Consulte la documentación para obtener información detallada sobre los países admitidos por Xsolla y el proceso de determinación del país. Example: country=US |
| show_inactive_time_limited_items | integer Default: 0 Muestra los artículos de duración limitada que no están disponibles para el usuario. El periodo de validez de dichos artículos no ha comenzado o ya ha expirado. Example: show_inactive_time_limited_items=1 |
El artículo virtual se recibió correctamente.
No se encontró el artículo. Asegúrese de que el project_id y el item_sku son correctos.
- 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": [ ]
}