# Obtener lista de artículos virtuales

Obtiene una lista de artículos virtuales para crear un catálogo.

Atención. Todos los proyectos tienen la limitación del número de artículos que puede obtener en la respuesta. El valor por defecto y máximo es 50 artículos por cada respuesta. Para obtener más datos página por página, utilice los campos limit y offset.

Endpoint: GET /v2/project/{project_id}/items/virtual_items
Version: 1.0.0
Security: AuthForClient

## Path parameters:

  - `project_id` (integer, required)
    ID del proyecto.
    Example: 44056

## Query parameters:

  - `limit` (integer)
    Límite para el número de elementos presentes en la página.
    Example: 50

  - `offset` (integer)
    Número del elemento a partir del cual se genera la lista (el conteo empieza desde el 0).

  - `locale` (string)
    Idioma de respuesta. Código de idioma de dos letras minúsculas según la norma ISO 639-1.

  - `additional_fields[]` (array)
    Lista de campos adicionales. Estos campos estarán en la respuesta si los envía en su solicitud. Campos disponibles media_list, order y long_description.

  - `country` (string)
    País para calcular los precios regionales y las restricciones del catálogo. Código de país de dos letras en mayúscula según la norma ISO 3166-1 alpha-2. Si no especifica el país explícitamente, se calculará en función de la dirección IP del usuario.

## Response 200 fields (application/json):

  - `items` (array)
    Example: [{"attributes":[{"external_id":"stack_size","name":"Stack size","values":[{"external_id":"size_e3364991f92e751689a68b96598a5a5a84010b85","value":"5"}]}],"description":"Big Rocket - description","groups":[{"external_id":"accessory","name":"Accessory"}],"image_url":"https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png","inventory_options":{"consumable":{"usages_count":1},"expiration_period":{"type":"day","value":1}},"is_free":false,"name":"Big Rocket","price":{"amount":"100.99","amount_without_discount":"100.99","currency":"USD"},"sku":"big_rocket","type":"virtual_good","virtual_item_type":"non_renewing_subscription","virtual_prices":[{"amount":100,"amount_without_discount":100,"description":"description","image_url":"http://image.png","is_default":true,"name":"SHOTGUN FOR TRUE RAIDERS","sku":"vc_test","type":"virtual_currency"}]},{"attributes":[{"external_id":"stack_size","name":"Stack size","values":[{"external_id":"size_e3364991f92e751689a68b96598a5a5a84010b85","value":"5"}]},{"external_id":"rating","name":"Rating","values":[{"external_id":"rating_e3364991f92e751689a68b96598a5a5a84010b85","value":"3.9"}]}],"description":"description","groups":[{"external_id":"hair","name":"Hair"}],"image_url":"http://image.png","inventory_options":{"consumable":{"usages_count":1},"expiration_period":{"type":"day","value":1}},"is_free":false,"name":"SHOTGUN FOR TRUE RAIDERS","price":{"amount":"101.0","amount_without_discount":"101.0","currency":"USD"},"sku":"shotgun_raider","type":"virtual_good","virtual_item_type":"non_renewing_subscription","virtual_prices":[{"amount":100,"amount_without_discount":100,"description":"description","image_url":"http://image.png","is_default":true,"name":"SHOTGUN FOR TRUE RAIDERS","sku":"vc_test","type":"virtual_currency"},{"amount":200,"amount_without_discount":200,"description":"description","image_url":"http://image.png","is_default":false,"name":"SHOTGUN FOR TRUE RAIDERS","sku":"vc_test_2","type":"virtual_currency"}]},{"attributes":[],"description":"description","groups":[],"image_url":"http://image.png","inventory_options":{"consumable":{"usages_count":1},"expiration_period":{"type":"day","value":1}},"is_free":true,"name":"SHOTGUN FOR TRUE RAIDERS","sku":"shotgun_raider_2","type":"virtual_good","virtual_item_type":"non_renewing_subscription","virtual_prices":[]}]

  - `items.attributes` (array)
    Lista de atributos y sus valores correspondientes al juego.

Atención: esta parte de la respuesta solo está disponible si envía el parámetro de consulta additional_fields[]=attributes.

  - `items.attributes.external_id` (string)
    ID único del atributo. external_id solo puede contener caracteres alfanuméricos del alfabeto latino en minúsculas, guiones y guiones bajos.
    Example: "attribute_1"

  - `items.attributes.name` (string)
    Nombre del atributo.
    Example: "Genre"

  - `items.attributes.values` (array)

  - `items.attributes.values.external_id` (string)
    ID de valor único para un atributo. external_id solo puede contener caracteres alfanuméricos del alfabeto latino en minúsculas, guiones y guiones bajos.
    Example: "attribute_value"

  - `items.attributes.values.value` (string)
    Valor del atributo.
    Example: "Strategy"

  - `items.description` (string)
    Descripción del artículo.
    Example: "Big Rocket - description"

  - `items.groups` (array)
    Grupos a los que pertenece el artículo.
    Example: [{"external_id":"accessory","name":"Accessory"}]

  - `items.groups.external_id` (string)
    Example: "accessory"

  - `items.groups.name` (string)
    Example: "Accessory"

  - `items.image_url` (string)
    URL de la imagen.
    Example: "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png"

  - `items.inventory_options` (object)
    Define las opciones de artículo del inventario.

  - `items.inventory_options.consumable` (object,null)
    Define las propiedades consumibles si se trata de un artículo consumible, o null si se trata de un artículo no consumible.

  - `items.inventory_options.consumable.usages_count` (integer,null)
    Número total de usos restantes si se trata de un artículo consumible, o null si se trata de un artículo no consumible.
    Example: 1

  - `items.inventory_options.expiration_period` (object,null)
    Define las propiedades de expiración si se trata de un artículo expirado, o null si se trata de un artículo no expirado.

  - `items.inventory_options.expiration_period.type` (string)
    Define el tipo de expiración del artículo.
    Enum: "minute", "hour", "day", "week", "month", "year"

  - `items.inventory_options.expiration_period.value` (integer)
    Define el valor de un periodo de expiración.
    Example: 1

  - `items.is_free` (boolean)
    Si es true, el artículo es gratuito.

  - `items.name` (string)
    Nombre del artículo.
    Example: "Big Rocket"

  - `items.price` (object)
    Precios de artículos.

  - `items.price.amount` (string)
    Precio del artículo con descuento.
    Example: "100.99"

  - `items.price.amount_without_discount` (string)
    Precio del artículo.
    Example: "100.99"

  - `items.price.currency` (string)
    Moneda de compra por defecto. Código de tres letras según la norma [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).
    Example: "USD"

  - `items.sku` (string)
    ID único del artículo. El código de un artículo (SKU) solo puede contener caracteres alfanuméricos latinos en minúsculas, puntos, guiones y guiones bajos.
    Example: "big_rocket"

  - `items.type` (string)
    Tipo de artículo: virtual_good/virtual_currency/bundle.
    Example: "virtual_good"

  - `items.virtual_item_type` (string)
    Tipo de artículo virtual.
    Enum: "consumable", "non_consumable", "non_renewing_subscription"

  - `items.virtual_prices` (array)
    Precios virtuales.

  - `items.virtual_prices.amount` (integer)
    Precio del artículo con descuento en moneda virtual.
    Example: 100

  - `items.virtual_prices.description` (string)
    Descripción de la moneda virtual.
    Example: "Big Rocket - description"

  - `items.virtual_prices.image_url` (string)
    Imagen de la moneda virtual.
    Example: "http://image.png"

  - `items.virtual_prices.is_default` (boolean)
    Si el precio está predeterminado o no para el artículo.
    Example: true

  - `items.virtual_prices.name` (string)
    Nombre de la moneda virtual.
    Example: "SHOTGUN FOR TRUE RAIDERS"

  - `items.virtual_prices.sku` (string)
    Código de artículo (SKU) de la moneda virtual.
    Example: "vc_test"

  - `items.virtual_prices.type` (string)
    Tipo de moneda virtual.
    Example: "virtual_currency"