# Obter lista de jogos Recebe uma lista de jogos 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 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 ## 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":"unit","unit_type":"game","description":"Game description","image_url":"https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png","attributes":[{"external_id":"genre","name":"Genre","values":[{"external_id":"23fda05111c125608af8f1fa0e99db45a10ea1cc","value":"Horror"}]}],"promotions":[],"unit_items":[{"sku":"com.xsolla.game_key_01","type":"game_key","is_free":false,"price":{"amount":"30.5","amount_without_discount":"30.5","currency":"USD"},"virtual_prices":[],"can_be_bought":true,"drm_name":"Steam","drm_sku":"steam_key_1","has_keys":true,"is_pre_order":true,"release_date":"2020-08-11T10:00:00+03:00","promotions":[],"periods":[{"date_from":"2020-08-11T10:00:00+03:00","date_until":"2020-08-11T20:00:00+03:00"}]},{"sku":"com.xsolla.game_key_02","type":"game_key","is_free":false,"price":{"amount":"30.5","amount_without_discount":"30.5","currency":"USD"},"virtual_prices":[],"can_be_bought":true,"drm_name":"Origin","drm_sku":"origin_key_1","has_keys":false,"is_pre_order":false,"release_date":null,"promotions":[],"periods":[]}]},{"sku":"com.xsolla.game_2","name":"Game name","groups":[{"external_id":"all","name":"All games"}],"type":"unit","unit_type":"game","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"}]}],"promotions":[],"unit_items":[{"sku":"com.xsolla.game_key_01","type":"game_key","is_free":false,"price":{"amount":"30.5","amount_without_discount":"30.5","currency":"USD"},"virtual_prices":[],"can_be_bought":true,"drm_name":"Steam","drm_sku":"steam_key_2","has_keys":false,"is_pre_order":false,"release_date":null,"promotions":[],"periods":[{"date_from":null,"date_until":"2020-08-11T20:00:00+03:00"}]}]}] - `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:virtual_good/virtual_currency/bundle/physical_good/unit. Example: "unit" - `items.unit_type` (string) Tipo de unidade: game. Example: "game" - `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.promotions` (array) Promoções aplicadas a itens específicos no carrinho. A matriz é retornada nos seguintes casos: * Uma promoção de desconto é configurada para um item específico. * Um código promocional com a configuração Desconto em itens selecionados é aplicado. Se nenhuma promoção no nível do item for aplicada, é retornada uma matriz vazia. - `items.promotions.name` (string) - `items.promotions.date_start` (string,null) - `items.promotions.date_end` (string,null) - `items.promotions.discount` (object,null) - `items.promotions.discount.percent` (string,null) - `items.promotions.discount.value` (string,null) - `items.promotions.bonus` (array) - `items.promotions.bonus.sku` (string) - `items.promotions.bonus.quantity` (integer) - `items.promotions.bonus.type` (string) Tipo de item bônus. Enum: "virtual_good", "virtual_currency", "bundle", "physical_good", "game_key", "nft" - `items.promotions.bonus.name` (string) Nome do item bônus. Indisponível para o tipo de item bônus physical_good. - `items.promotions.bonus.image_url` (string) URL da imagem do item bônus. Indisponível para o tipo de item bônus physical_good. - `items.promotions.bonus.bundle_type` (string) Tipo de item de pacote de bônus. Disponível apenas para o tipo de item bônus bundle. Enum: "standard", "virtual_currency_package" - `items.promotions.limits` (object) - `items.promotions.limits.per_user` (object) - `items.promotions.limits.per_user.available` (integer) - `items.promotions.limits.per_user.total` (integer) - `items.unit_items` (array) - `items.unit_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.unit_items.type` (string) Tipo de item: game_key. Example: "game_key" - `items.unit_items.is_free` (boolean) Se o item é gratuito ou não. - `items.unit_items.price` (object) Preços dos itens. - `items.unit_items.price.amount` (string) Preço do item com desconto. Example: "2.9900" - `items.unit_items.price.amount_without_discount` (string) Preço do item. Example: "2.9900" - `items.unit_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.unit_items.virtual_prices` (array) Preços virtuais. - `items.unit_items.virtual_prices.amount` (integer) Preço do item em moeda virtual. Example: 100 - `items.unit_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.unit_items.virtual_prices.sku` (string) SKU de moeda virtual. Example: "vc_gold" - `items.unit_items.virtual_prices.is_default` (boolean) Se o preço padrão é definido em uma moeda virtual ou não. Example: true - `items.unit_items.virtual_prices.image_url` (string,null) URL de imagem da moeda virtual Example: "http://image.png" - `items.unit_items.virtual_prices.name` (string) Nome da moeda virtual. Example: "Gold" - `items.unit_items.virtual_prices.type` (string) Tipo de item. Para moedas virtuais, é virtual_currency. Example: "virtual_currency" - `items.unit_items.virtual_prices.description` (string,null) Descrição da moeda virtual. Example: "In-game currency used to purchase weapons and upgrades" - `items.unit_items.can_be_bought` (boolean) Se true, o usuário pode comprar um item. - `items.unit_items.drm_name` (string) Nome do DRM. Example: "Steam" - `items.unit_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.unit_items.has_keys` (boolean) Se true, a chave de jogo tem chaves para venda. - `items.unit_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.unit_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.unit_items.promotions` (array) Promoções aplicadas a itens específicos no carrinho. A matriz é retornada nos seguintes casos: * Uma promoção de desconto é configurada para um item específico. * Um código promocional com a configuração Desconto em itens selecionados é aplicado. Se nenhuma promoção no nível do item for aplicada, é retornada uma matriz vazia. - `items.unit_items.promotions.name` (string) - `items.unit_items.promotions.date_start` (string,null) - `items.unit_items.promotions.date_end` (string,null) - `items.unit_items.promotions.discount` (object,null) - `items.unit_items.promotions.discount.percent` (string,null) - `items.unit_items.promotions.discount.value` (string,null) - `items.unit_items.promotions.bonus` (array) - `items.unit_items.promotions.bonus.sku` (string) - `items.unit_items.promotions.bonus.quantity` (integer) - `items.unit_items.promotions.bonus.type` (string) Tipo de item bônus. Enum: "virtual_good", "virtual_currency", "bundle", "physical_good", "game_key", "nft" - `items.unit_items.promotions.bonus.name` (string) Nome do item bônus. Indisponível para o tipo de item bônus physical_good. - `items.unit_items.promotions.bonus.image_url` (string) URL da imagem do item bônus. Indisponível para o tipo de item bônus physical_good. - `items.unit_items.promotions.bonus.bundle_type` (string) Tipo de item de pacote de bônus. Disponível apenas para o tipo de item bônus bundle. Enum: "standard", "virtual_currency_package" - `items.unit_items.promotions.limits` (object) - `items.unit_items.promotions.limits.per_user` (object) - `items.unit_items.promotions.limits.per_user.available` (integer) - `items.unit_items.promotions.limits.per_user.total` (integer) - `items.unit_items.periods` (array,null) Período de venda de itens. - `items.unit_items.periods.date_from` (string) Data em que o item especificado estará disponível para venda. Example: "2020-08-11T10:00:00+03:00" - `items.unit_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.unit_items.vp_rewards` (array) Lista de recompensas de pontos de valor para o item. - `items.unit_items.vp_rewards.item_id` (integer) ID de item exclusivo interno. - `items.unit_items.vp_rewards.sku` (string) ID de ponto de valor exclusivo. - `items.unit_items.vp_rewards.amount` (integer) Quantidade de pontos de valor. - `items.unit_items.vp_rewards.name` (string) Nome do ponto de valor. - `items.unit_items.vp_rewards.image_url` (string) URL da imagem. - `items.unit_items.vp_rewards.is_clan` (boolean) Se o ponto de valor é usado em cadeias de recompensa de clã ou não. - `items.unit_items.loyalty_rewards` (array) Pontos de fidelidade que o usuário recebe como recompensa por comprar o item. - `items.unit_items.loyalty_rewards.name` (string) Nome dos pontos de fidelidade. - `items.unit_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.unit_items.loyalty_rewards.description` (string) Descrição dos pontos de fidelidade. - `items.unit_items.loyalty_rewards.image_url` (string,null) URL da imagem. - `items.unit_items.loyalty_rewards.amount` (integer) Quantidade de pontos de fidelidade que o usuário recebe por comprar o item. - `items.unit_items.loyalty_prices` (array) Pontos de fidelidade que podem ser usados para comprar o item. - `items.unit_items.loyalty_prices.name` (string) Nome dos pontos de fidelidade. - `items.unit_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.unit_items.loyalty_prices.description` (string) Descrição dos pontos de fidelidade. - `items.unit_items.loyalty_prices.image_url` (string,null) URL da imagem. - `items.unit_items.loyalty_prices.amount` (integer) Preço do item especificado em pontos de fidelidade.