Xsolla-logo

Obtener clave del juego para el catálogoClient-side

get/v2/project/{project_id}/items/game/key/sku/{item_sku}

Obtiene una clave del juego para el 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
Default: "xsollus_basic_edition_steam"

Código (SKU) del artículo.

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.

additional_fields[]
Array of strings

La lista de campos adicionales. Estos campos estarán en la respuesta si los envía en su solicitud.

Items Enum: "media_list" "order" "long_description" "custom_attributes"
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 países admitidos por Xsolla y el proceso de determinación del país.

Example: country=US
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

La clave del juego se recibió correctamente.

404

Clave del juego no encontrada.

Request samples
Response samples
application/json
{
  • "attributes": [
    ],
  • "can_be_bought": true,
  • "description": "Game description",
  • "drm_name": "Steam",
  • "drm_sku": "steam",
  • "groups": [
    ],
  • "has_keys": true,
  • "is_free": false,
  • "is_pre_order": true,
  • "limits": null,
  • "name": "Game name",
  • "periods": [
    ],
  • "price": {
    },
  • "promotions": [ ],
  • "release_date": "2020-08-11T10:00:00+03:00",
  • "sku": "game_1",
  • "type": "game_key",
  • "virtual_prices": [ ]
}