Xsolla-logo

Obtener artículo virtual por código de artículo (SKU)Client-side

get/v2/project/{project_id}/items/virtual_items/sku/{item_sku}

Obtiene un artículo virtual mediante el código de artículo (SKU) para crear un catálogo.

Tenga en cuenta que:

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 obtener un resultado personalizado, como los límites de usuarios y las promociones disponibles.
SecurityXsollaLoginUserJWT
Request
path Parameters
project_id
required
integer

ID del proyecto. Encontrará este parámetro en su cuenta Publisher junto al nombre del proyecto.

Example: 44056
item_sku
required
string

Código (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 en mayúscula según la noema ISO 3166-1 alpha-2. Muestra los precios y restricciones regionales de un catálogo si se especificaron al crear un artículo.

Nota

Si no especifica el país explícitamente, se establecerá en función de la dirección IP del usuario.

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
Responses
200

El artículo virtual se recibió correctamente.

404

No se encontró el artículo. Asegúrese de que el project_id y el item_sku son correctos.

Request samples
Response samples
application/json
{
  • "attributes": [
    ],
  • "can_be_bought": true,
  • "custom_attributes": {
    },
  • "description": {
    },
  • "groups": [
    ],
  • "inventory_options": {
    },
  • "is_free": false,
  • "item_id": 488833,
  • "limits": {
    },
  • "name": {
    },
  • "periods": [
    ],
  • "price": {
    },
  • "promotions": [ ],
  • "sku": "swords_1",
  • "type": "virtual_good",
  • "virtual_item_type": "non_consumable",
  • "virtual_prices": [ ],
  • "vp_rewards": [ ]
}