# Obter lista de pacotes de moedas virtuais por grupo especificado Recupera uma lista de pacotes de moedas virtuais do grupo especificado para construir 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/virtual_currency/package/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) - `items.item_id` (integer) ID de item único atribuído pela Xsolla. - `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: "crystal-pack" - `items.name` (string) Nome do item. Example: "Crystal Pack" - `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: "bundle" - `items.bundle_type` (string) Tipo de conjunto. Sempre virtual_currency_package para pacotes de moedas virtuais. Example: "virtual_currency_package" - `items.description` (string) Descrição do item. Example: "Crystal Pack Description" - `items.image_url` (string) URL da imagem. Example: "https://cdn.xsolla.net/items/crystal-pack.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: "100.99" - `items.price.amount_without_discount` (string) Preço do item sem desconto. 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) Virtual currency description. 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.content` (array) Conteúdo do pacote de moedas virtuais. Example: [{"description":"Crystal - short description","image_url":"https://cdn.xsolla.net/items/crystal-pack.png","sku":"com.xsolla.crystal_1","name":"Crystals","type":"virtual_currency","quantity":100}] - `items.content.sku` (string) ID de item exclusivo. O SKU só pode conter caracteres alfanuméricos latinos minúsculos e maiúsculos, traços e sublinhados. Example: "com.xsolla.crystal_1" - `items.content.quantity` (integer) Quantidade de moeda virtual no pacote. Example: 250 - `items.content.limits` (object,null) Limites de itens. - `items.content.limits.per_user` (object,null) Limites de item para um usuário. - `items.content.limits.per_user.total` (integer) Quantidade máxima de itens que o usuário atual pode comprar. Example: 5 - `items.content.limits.per_user.available` (integer) Quantidade restante de itens que o usuário atual pode comprar. Example: 3 - `items.content.limits.per_user.recurrent_schedule` (any) - `items.content.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.content.limits.per_item` (object,null) Limites de item para um item. - `items.content.limits.per_item.total` (integer) Quantidade máxima de itens que todos os usuários podem comprar. Example: 5 - `items.content.limits.per_item.available` (integer) Quantidade restante de itens que todos os usuários podem comprar. Example: 3 - `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.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.is_clan` (boolean) Se o ponto de valor é usado em cadeias de recompensa de clã ou não. ## Response 404 fields (application/json): - `statusCode` (integer) Código de status de resposta HTTP. Example: 404 - `errorCode` (integer) Código de erro Xsolla Example: 4403 - `errorMessage` (string) Descrição de erro curta. Example: "[0401-4403]: Item group not found"