# Obter lista de chaves de jogo por grupo especificado Recebe uma lista de chaves de jogo do grupo especificado para montar um catálogo. Atenção Todos os projetos têm uma limitação no número de itens que você pode obter na resposta. O valor padrão e máximo é 50 itens por resposta. Para obter mais dados página por página, use os campos limit e offset. Nota Esta chamada de API retorna dados genéricos do catálogo de itens quando usada sem autorização. Use a autorização para recuperar dados personalizados do usuário, como limites e promoções associadas ao item. Para fazer isso, passe o JWT do usuário no cabeçalho Authorization. Para mais informações sobre o JWT do usuário, consulte o bloco Segurança para esta chamada. Endpoint: GET /v2/project/{project_id}/items/game/key/group/{external_id} Version: 2.0.0 Security: XsollaLoginUserJWT ## Path parameters: - `project_id` (integer, required) ID de projeto. Você pode encontrar esse parâmetro na sua Conta de Distribuidor, próximo ao nome do projeto e na barra de endereços do navegador ao trabalhar com um projeto. O URL tem o seguinte formato: https://publisher.xsolla.com//projects/. Example: 44056 - `external_id` (string, required) ID de grupo de itens externo especificado durante a criação. Example: "weapons" ## Query parameters: - `limit` (integer) Limite da quantidade de elementos na página. Example: 50 - `offset` (integer) Número do elemento a partir do qual a lista é gerada (a quantidade começa a partir de 0). - `locale` (string) Idioma de resposta. Código de idioma de duas letras minúsculas, de acordo com o padrão ISO 639-1 (por exemplo, en). Códigos de localização de cinco caracteres (por exemplo, en-US) são suportados nos campos de tradução, tais como name e description, mas são normalizados a códigos de duas letras nas respostas. Você pode encontrar a lista completa de idiomas suportados na documentação. - `additional_fields[]` (array) Campos adicionais para incluir na resposta. Por padrão, esses campos não são retornados. Passe os valores necessários para incluí-los. 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: "US" - `promo_code` (string) Código exclusivo que diferencia maiúsculas de minúsculas. Contém letras e números. Example: "WINTER2021" - `show_inactive_time_limited_items` (integer) 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: 1 ## Response 200 fields (application/json): - `has_more` (boolean) Usado como um indicador de que há mais páginas. - `items` (array) Example: [{"sku":"com.xsolla.game_1","name":"Game name","groups":[{"external_id":"all","name":"All games"},{"external_id":"Xsolla","name":"Xsolla games"}],"type":"game_key","description":"Game description","image_url":"https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png","attributes":[{"external_id":"OS","name":"OS","values":[{"external_id":"9d5c5efb7c0f00a00fe4e3583f1215b0050bc723","value":"Windows"}]},{"external_id":"genre","name":"Genre","values":[{"external_id":"23fda05111c125608af8f1fa0e99db45a10ea1cc","value":"Horror"}]}],"is_free":false,"price":{"amount":"30.5","amount_without_discount":"30.5","currency":"USD"},"virtual_prices":[],"drm_name":"Steam","drm_sku":"steam_key_1","has_keys":true,"is_pre_order":true,"release_date":"2020-08-11T10:00:00+03:00","periods":[{"date_from":"2020-08-11T10:00:00+03:00","date_until":"2020-08-11T20:00:00+03:00"}]},{"sku":"com.xsolla.game_2","name":"Game name","groups":[{"external_id":"all","name":"All games"}],"type":"game_key","description":"Game description","image_url":"https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png","attributes":[{"external_id":"OS","name":"OS","values":[{"external_id":"9d5c5efb7c0f00a00fe4e3583f1215b0050bc723","value":"Windows"}]},{"external_id":"genre","name":"Genre","values":[{"external_id":"23fda05111c125608af8f1fa0e99db45a10ea1cc","value":"Horror"}]}],"is_free":false,"price":{"amount":"30.5","amount_without_discount":"30.5","currency":"USD"},"virtual_prices":[],"drm_name":"Steam","drm_sku":"steam_key_2","has_keys":true,"is_pre_order":false,"release_date":null,"periods":[]}] - `items.sku` (string) ID de item exclusivo. O SKU só pode conter caracteres alfanuméricos latinos minúsculos e maiúsculos, pontos, traços e sublinhados. Example: "game_01" - `items.name` (string) Nome do item. Example: "Game name" - `items.groups` (array) Grupo aos quais o item pertence. - `items.groups.external_id` (string) [ID de grupo de itens externo](/pt/api/catalog/item-groups-admin/admin-create-item-group#item-groups-admin/admin-create-item-group/t=request&path=external_id) especificado durante a criação. Example: "exclusive" - `items.groups.name` (string) Nome do grupo. Example: "Exclusive" - `items.groups.item_order_in_group` (integer) A posição do item dentro do grupo que determina sua ordem de exibição. Retornado somente se solicitado pelo parâmetro de pesquisa additional_fields[] Example: 1 - `items.attributes` (array) Lista de atributos e seus valores correspondentes ao item. Pode ser usado para a filtragem de catálogos. - `items.attributes.external_id` (string) ID de atributo exclusivo. O external_id só pode conter caracteres alfanuméricos latinos minúsculos e maiúsculos, traços e sublinhados. - `items.attributes.name` (string) Nome do atributo. Example: "Genre" - `items.attributes.values` (array) - `items.attributes.values.external_id` (string) ID de valor exclusivo para um atributo. O external_id pode conter apenas caracteres alfanuméricos latinos minúsculos, traços e sublinhados. - `items.attributes.values.value` (string) Valor do atributo. Example: "Strategy" - `items.type` (string) Tipo de item: game_key. Example: "game_key" - `items.description` (string) Descrição do item. Example: "Game description" - `items.image_url` (string) URL da imagem. Example: "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png" - `items.is_free` (boolean) Se o item é gratuito ou não. - `items.price` (object) Preços dos itens. - `items.price.amount` (string) Preço do item com desconto. Example: "2.9900" - `items.price.amount_without_discount` (string) Preço do item. Example: "2.9900" - `items.price.currency` (string) Moeda do preço do item. Código de três letras de acordo com [a ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). Example: "USD" - `items.virtual_prices` (array) Preços virtuais. - `items.virtual_prices.amount` (integer) Preço do item em moeda virtual. Example: 100 - `items.virtual_prices.amount_without_discount` (integer) Preço do item em moedas virtuais sem desconto. Sempre igual a amount já que descontos não são aplicados a preços em moedas virtuais. Example: 200 - `items.virtual_prices.sku` (string) SKU de moeda virtual. Example: "vc_gold" - `items.virtual_prices.is_default` (boolean) Se o preço padrão é definido em uma moeda virtual ou não. Example: true - `items.virtual_prices.image_url` (string,null) URL de imagem da moeda virtual Example: "http://image.png" - `items.virtual_prices.name` (string) Nome da moeda virtual. Example: "Gold" - `items.virtual_prices.type` (string) Tipo de item. Para moedas virtuais, é virtual_currency. Example: "virtual_currency" - `items.virtual_prices.description` (string,null) Descrição da moeda virtual. Example: "In-game currency used to purchase weapons and upgrades" - `items.drm_name` (string) Nome do DRM. Example: "Steam" - `items.drm_sku` (string) ID de DRM exclusivo. O SKU só pode conter caracteres alfanuméricos latinos minúsculos e maiúsculos, pontos, traços e sublinhados. Example: "steam" - `items.has_keys` (boolean) Se true, a chave de jogo tem chaves para venda. - `items.is_pre_order` (boolean) Se true, a chave do jogo é uma pré-venda e a data de lançamento não foi passada. Example: true - `items.release_date` (string,null) Data de lançamento da chave de jogo no formato ISO 8601. Example: "2020-08-11T10:00:00+03:00" - `items.periods` (array) Período de venda de itens. - `items.periods.date_from` (string,null) Data em que o item especificado estará disponível para venda. Example: "2020-08-11T10:00:00+03:00" - `items.periods.date_until` (string,null) Data em que o item especificado ficará indisponível para venda. Pode ser null. Example: "2020-08-11T20:00:00+03:00" - `items.loyalty_rewards` (array) Pontos de fidelidade que o usuário recebe como recompensa por comprar o item. - `items.loyalty_rewards.name` (string) Nome dos pontos de fidelidade. - `items.loyalty_rewards.sku` (string) SKU de pontos de fidelidade. Passe esse valor no parâmetro loyalty_point_sku de outras chamadas de API, por exemplo, ao criar um pedido pago com pontos de fidelidade. - `items.loyalty_rewards.description` (string) Descrição dos pontos de fidelidade. - `items.loyalty_rewards.image_url` (string,null) URL da imagem. - `items.loyalty_rewards.amount` (integer) Quantidade de pontos de fidelidade que o usuário recebe por comprar o item. - `items.loyalty_prices` (array) Pontos de fidelidade que podem ser usados para comprar o item. - `items.loyalty_prices.name` (string) Nome dos pontos de fidelidade. - `items.loyalty_prices.sku` (string) SKU de pontos de fidelidade. Passe esse valor no parâmetro loyalty_point_sku de outras chamadas de API, por exemplo, ao criar um pedido pago com pontos de fidelidade. - `items.loyalty_prices.description` (string) Descrição dos pontos de fidelidade. - `items.loyalty_prices.image_url` (string,null) URL da imagem. - `items.loyalty_prices.amount` (integer) Preço do item especificado em pontos de fidelidade.