Xsolla-logo

Obter chave de jogo para catálogo

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

Obtém uma chave de jogo para o catálogo.

Observação

Esse ponto de extremidade, acessível sem autorização, retorna dados genéricos. No entanto, a autorização enriquece a resposta com detalhes específicos do usuário para um resultado personalizado, como limites de usuários disponíveis e promoções.
SecurityXsollaLoginUserJWT
Request
path Parameters
project_id
required
integer

ID do projeto. Você pode encontrar esse parâmetro em sua Conta de Distribuidor ao lado do nome do projeto.

Example: 44056
item_sku
required
string
Default: "xsollus_basic_edition_steam"

SKU do item.

query Parameters
locale
string
Default: "en"

Linguagem de resposta. Código de idioma minúsculo de duas letras de acordo com o padrão ISO 639-1.

additional_fields[]
Array of strings

A lista de campos adicionais. Esses campos estarão na resposta se você enviá-los em sua solicitação.

Items Enum: "media_list" "order" "long_description" "custom_attributes"
country
string

Código de país maiúsculo de duas letras de acordo com o padrão ISO 3166-1 alpha-2. Mostra os preços regionais e as restrições de um catálogo se eles foram especificados durante a criação de um item.

Observação

Se você não especificar o país explicitamente, ele será definido com base no endereço IP do usuário.

Example: country=US
promo_code
string [ 1 .. 128 ] characters

Código exclusivo que diferencia maiúsculas de minúsculas. Contém letras e números.

Example: promo_code=WINTER2021
show_inactive_time_limited_items
integer
Default: 0

Exibe itens de tempo limitado que não estão disponíveis para o usuário. O prazo de validade desses itens não começou ou já expirou.

Example: show_inactive_time_limited_items=1
Responses
200

A chave de jogo foi recebida com sucesso.

404

Chave de jogo não 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": [ ]
}