Obtener artículo vendible por ID

Nota

Este punto final, accesible sin autorización, devuelve datos genéricos. No obstante, la autorización enriquece la respuesta con detalles específicos del usuario para obtener un resultado personalizado, como los límites de usuario y las promociones disponibles.

SecurityXsollaLoginUserJWT

Request

path Parameters

project_id required	integer ID del proyecto. Encontrará este parámetro en su Cuenta del editor junto al nombre del proyecto. Example: 59080
item_id required	string ID del artículo. Example: 259774

query Parameters

promo_code	string [ 1 .. 128 ] characters Código único que distingue entre mayúsculas y minúsculas. Contiene letras y números. Example: promo_code=WINTER2021
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 vendible se recibió correctamente.

404

Artículo no encontrado. Asegúrese de que el project_id y el item_id sean correctos.

Request samples

Response samples

application/json

{"attributes": [ ],
"can_be_bought": true,
"custom_attributes": {"attr": "value",
"purchased": 0
},
"description": "Electric shield",
"groups": [{"external_id": "armour",
"name": "Armour"
}
],
"image_url": "https://cdn3.xsolla.com/img/misc/images/d2d6b1b517e6a7f3765c3bb5a3cfb87d.png",
"inventory_options": {"consumable": null,
"expiration_period": null
},
"is_free": false,
"item_id": 259774,
"limits": {"per_user": {"available": 3,
"recurrent_schedule": {"interval_type": "weekly",
"reset_next_date": 1746057600
},
"total": 5
}
},
"name": "Electric shield",
"price": {"amount": "9.99",
"amount_without_discount": "9.99",
"currency": "USD"
},
"promotions": [{"bonus": [{"image_url": "https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png",
"name": "Xsolla Minigun",
"quantity": 1,
"sku": "com.xsolla.minigun_1",
"type": "virtual_good"
}
],
"date_end": "2026-04-15T16:16:00+03:00",
"date_start": "2020-04-15T16:16:00+03:00",
"discount": {"percent": "50.00"
},
"name": "Bonus promotion"
}
],
"sku": "com.xsolla.electric_shield_1",
"type": "virtual_good",
"virtual_item_type": "non_consumable",
"virtual_prices": [{"amount": 10,
"amount_without_discount": 10,
"calculated_price": {"amount": "10.00",
"amount_without_discount": "10.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png",
"is_default": true,
"item_id": 259765,
"name": "Gold",
"sku": "com.xsolla.gold_1",
"type": "virtual_currency"
},
{"amount": 20,
"amount_without_discount": 20,
"calculated_price": {"amount": "20.00",
"amount_without_discount": "20.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/015e4f4ea4deb1e2c92d5c21a4d58309.png",
"is_default": false,
"item_id": 259766,
"name": "Silver",
"sku": "com.xsolla.silver_1",
"type": "virtual_currency"
},
{"amount": 200,
"amount_without_discount": 200,
"calculated_price": {"amount": "200.00",
"amount_without_discount": "200.00"
},
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/b0beedd5763b612bd3a5631e6cb1d1ff.png",
"is_default": false,
"item_id": 259767,
"name": "Bronze",
"sku": "com.xsolla.bronze_1",
"type": "virtual_currency"
}
],
"vp_rewards": [{"amount": 130,
"image_url": "https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg",
"item_id": 175232,
"name": "Value point",
"sku": "com.xsolla.value_point_1"
},
{"amount": 50,
"image_url": "https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg",
"is_clan": true,
"item_id": 186321,
"name": "Clan Reward VP 1",
"sku": "com.xsolla.clan_value_point_1"
}
]
}