Xsolla-logo

Obtener clave del juego para el catálogo

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 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 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
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": [ ]
}