# Obter lista de itens virtuais Recebe uma lista de itens virtuais para montar um catálogo. Aviso Todos os projetos têm a limitação do 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. Veja também: A chamada de API Obter lista de todos os itens virtuais para busca ou indexação no lado do cliente. Endpoint: GET /v2/project/{project_id}/items/virtual_items 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) - `items.item_id` (number) ID do item. - `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: "big_rocket" - `items.name` (object) Nome do item. Example: "Big Rocket" - `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` (object) 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. Example: "virtual_good" - `items.description` (object) Descrição do item. Example: "Big Rocket - description" - `items.image_url` (string) URL da imagem. Example: "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png" - `items.is_free` (boolean) Se o item é gratuito ou não. - `items.price` (object,null) Preços dos itens. - `items.price.amount` (string) Preço do item com desconto. Example: "100.99" - `items.price.amount_without_discount` (string) Preço do item. Example: "100.99" - `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). Consulte a documentação para obter informações detalhadas sobre [as moedas suportadas pelo Xsolla](https://developers.xsolla.com/pt/doc/pay-station/references/supported-currencies/). 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.can_be_bought` (boolean) Se true, o usuário pode comprar um item. - `items.virtual_item_type` (string) Tipo de item virtual. Possíveis valores: - consumable — Um item que desaparece do inventário após o uso (ex.: munição).. - non_consumable — Um item que permanece no inventário por um tempo ilimitado. - non_renewing_subscription — Item de tempo limitado que pode representar acesso a serviços ou conteúdos por um período específico. Enum: "consumable", "non_consumable", "non_renewing_subscription" - `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.limits` (object,null) Limites de itens. - `items.limits.per_user` (object,null) Limitação de item para um usuário separado. - `items.limits.per_user.total` (integer) Quantidade máxima de itens que o usuário atual pode comprar. - `items.limits.per_user.available` (integer) Quantidade restante de itens que o usuário atual pode comprar. - `items.limits.per_user.recurrent_schedule` (any) - `items.limits.per_user.limit_exceeded_visibility` (string) Determina a visibilidade do item no catálogo após o limite de compra ser atingido, até o próximo limite ser redefinido. Aplica-se a itens para os quais redefinições recorrentes de limite estão configurados na matriz recurrent_schedule. Se os limites redefinidos não forem configurados, o item não aparecerá no catálogo após o limite de compra ser atingido, independentemente do valor limit_exceeded_visibility. Possíveis valores: - show — O item é retornado nas chamadas API de recuperação de catálogo após o limite de compra ser atingido. Nas chamadas API de recuperação de catálogo, quando o limite for atingido, o item será retornado com a marcação can_be_bought: false. A próxima data de redefinição é retornada em reset_next_date. - hide — O item não é retornado nas chamadas API de recuperação de catálogo após o limite de compra ser atingido, até o limite ser redefinido. Enum: "show", "hide" - `items.limits.per_item` (object,null) Limitação global de itens. - `items.limits.per_item.total` (integer) Quantidade máxima de itens que todos os usuários podem comprar. - `items.limits.per_item.available` (integer) Quantidade restante de itens que todos os usuários podem comprar. - `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.custom_attributes` (object) Um objeto JSON que contém atributos e valores de item. - `items.vp_rewards` (array) Lista de recompensas de pontos de valor para o item. - `items.vp_rewards.item_id` (integer) ID de item exclusivo interno. - `items.vp_rewards.sku` (string) ID de ponto de valor exclusivo. - `items.vp_rewards.amount` (integer) Quantidade de pontos de valor. - `items.vp_rewards.name` (string) Nome do ponto de valor. - `items.vp_rewards.image_url` (string) URL da imagem. - `items.vp_rewards.is_clan` (boolean) Se o ponto de valor é usado em cadeias de recompensa de clã ou não. - `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.