Obter lista de chaves de jogo por grupo especificado

Atenção

Todos os projetos têm uma limitação na quantidade de itens que você pode receber na resposta. O valor padrão e máximo é de 50 itens por resposta. Para obter mais dados página por página, use os campos limit e offset.

Observação

O use das chamadas API de catálogo de itens está disponível sem autorização, mas para obter um catálogo personalizado, você deve passar o JWT do usuário no cabeçalho da Autorização.

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
external_id required	string Default: "all" ID externo de grupo.

query Parameters

limit	integer >= 1 Limite da quantidade de elementos na página. Example: limit=50
offset	integer >= 0 Número do elemento a partir do qual a lista é gerada (a quantidade começa a partir de 0). Example: offset=0
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" "item_order_in_group"
country	string Código de país de duas letras maiúsculas de acordo com o padrão ISO 3166-1 alfa-2. Verifique a documentação para obter informações detalhadas sobre os países suportados pela Xsolla e o processo de determinação do país. 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 lista de chaves de jogo foi recebida com sucesso.

Request samples

Response samples

application/json

{"has_more": true,
"items": [{"attributes": [{"external_id": "OS",
"name": "OS",
"values": [{"external_id": "9d5c5efb7c0f00a00fe4e3583f1215b0050bc723",
"value": "Windows"
}
]
},
{"external_id": "genre",
"name": "Genre",
"values": [{"external_id": "23fda05111c125608af8f1fa0e99db45a10ea1cc",
"value": "Horror"
}
]
}
],
"description": "Game description",
"drm_name": "Steam",
"drm_sku": "steam_key_1",
"groups": [{"external_id": "all",
"item_order_in_group": 2,
"name": "All games"
},
{"external_id": "Xsolla",
"item_order_in_group": 1,
"name": "Xsolla games"
}
],
"has_keys": true,
"image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png",
"is_free": false,
"is_pre_order": true,
"name": "Game name",
"periods": [{"date_from": "2020-08-11T10:00:00+03:00",
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"price": {"amount": "30.5",
"amount_without_discount": "30.5",
"currency": "USD"
},
"release_date": "2020-08-11T10:00:00+03:00",
"sku": "com.xsolla.game_1",
"type": "game_key",
"virtual_prices": [ ]
},
{"attributes": [{"external_id": "OS",
"name": "OS",
"values": [{"external_id": "9d5c5efb7c0f00a00fe4e3583f1215b0050bc723",
"value": "Windows"
}
]
},
{"external_id": "genre",
"name": "Genre",
"values": [{"external_id": "23fda05111c125608af8f1fa0e99db45a10ea1cc",
"value": "Horror"
}
]
}
],
"description": "Game description",
"drm_name": "Steam",
"drm_sku": "steam_key_2",
"groups": [{"external_id": "all",
"item_order_in_group": 1,
"name": "All games"
}
],
"has_keys": true,
"image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png",
"is_free": false,
"is_pre_order": false,
"name": "Game name",
"periods": [ ],
"price": {"amount": "30.5",
"amount_without_discount": "30.5",
"currency": "USD"
},
"release_date": null,
"sku": "com.xsolla.game_2",
"type": "game_key",
"virtual_prices": [ ]
}
]
}