# Obtener la lista de claves de juego por grupo especificado

Obtiene una lista de claves de juego del grupo especificado para crear un catálogo.

AtenciónTodos los proyectos tienen la limitación de número de artículos que se pueden obtener en la respuesta. El valor por defecto y máximo es de 50 artículos por respuesta. Para obtener más datos, página por página, utilice los campos limit y offset.  NotaEl uso de las llamadas API del catálogo de artículos está disponible sin autorización, pero para obtener un catálogo personalizado, debe transmitir el JWT de usuario en el encabezado Authorization.

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 del proyecto. Encontrará este parámetro en su Cuenta del editor junto al nombre del proyecto.
    Example: 44056

  - `external_id` (string, required)
    ID externo del grupo.

## 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)
    La lista de campos adicionales. Estos campos estarán en la respuesta si los envía en su solicitud.
    Enum: "media_list", "order", "long_description", "custom_attributes", "item_order_in_group"

  - `country` (string)
    Código de país de dos letras mayúsculas de conformidad con la norma ISO 3166-1 alpha-2. Consulte la documentación para obtener información detallada sobre los países admitidos por Xsolla y el proceso de determinación del país.
    Example: "US"

  - `promo_code` (string)
    Código único que distingue entre mayúsculas y minúsculas. Contiene letras y números.
    Example: "WINTER2021"

  - `show_inactive_time_limited_items` (integer)
    Muestra los artículos de duración limitada que no están disponibles para el usuario. El periodo de validez de dichos artículos no ha comenzado o ya ha expirado.
    Example: 1

## Response 200 fields (application/json):

  - `has_more` (boolean)
    Se utiliza como indicador de que hay más páginas.
    Example: true

  - `items` (array)
    Example: [{"attributes":[{"external_id":"OS","name":"OS","values":[{"external_id":"9d5c5efb7c0f00a00fe4e3583f1215b0050bc723","value":"Windows"}]},{"external_id":"genre","name":"Genre","values":[{"external_id":"23fda05111c125608af8f1fa0e99db45a10ea1cc","value":"Horror"}]}],"description":"Game description","drm_name":"Steam","drm_sku":"steam_key_1","groups":[{"external_id":"all","name":"All games"},{"external_id":"Xsolla","name":"Xsolla games"}],"has_keys":true,"image_url":"https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png","is_free":false,"is_pre_order":true,"name":"Game name","periods":[{"date_from":"2020-08-11T10:00:00+03:00","date_until":"2020-08-11T20:00:00+03:00"}],"price":{"amount":"30.5","amount_without_discount":"30.5","currency":"USD"},"release_date":"2020-08-11T10:00:00+03:00","sku":"com.xsolla.game_1","type":"game_key","virtual_prices":[]},{"attributes":[{"external_id":"OS","name":"OS","values":[{"external_id":"9d5c5efb7c0f00a00fe4e3583f1215b0050bc723","value":"Windows"}]},{"external_id":"genre","name":"Genre","values":[{"external_id":"23fda05111c125608af8f1fa0e99db45a10ea1cc","value":"Horror"}]}],"description":"Game description","drm_name":"Steam","drm_sku":"steam_key_2","groups":[{"external_id":"all","name":"All games"}],"has_keys":true,"image_url":"https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png","is_free":false,"is_pre_order":false,"name":"Game name","periods":[],"price":{"amount":"30.5","amount_without_discount":"30.5","currency":"USD"},"release_date":null,"sku":"com.xsolla.game_2","type":"game_key","virtual_prices":[]}]

  - `items.attributes` (array)
    Lista de atributos y sus valores correspondientes al artículo. Puede utilizarse para filtrar el catálogo.
    Example: {"value":{"external_id":"genre","name":"Жанр","values":[{"external_id":"genre_e3364991f92e751689a68b96598a5a5a84010b85","value":"Casual"},{"external_id":"genre_eba07bfd0f982940773cba3744d97264dd58acd7","value":"Strategy"},{"external_id":"genre_b8d0c6d8f0524c2b2d79ebb93aa3cd0e8b5199a8","value":"Mobile"}]}}

  - `items.attributes.external_id` (string)
    ID único del atributo. external_id solo puede contener caracteres alfanuméricos latinos en minúsculas y mayú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 del valor único para un atributo. external_id solo puede contener caracteres alfanuméricos latinos 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: "Game description"

  - `items.drm_name` (string)
    Nombre del DRM (gestión de derechos digitales).
    Example: "Steam"

  - `items.drm_sku` (string)
    ID único de DRM. El SKU solo puede contener caracteres alfanuméricos latinos en minúsculas y mayúsculas, puntos, guiones y guiones bajos.
    Example: "steam"

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

  - `items.groups.external_id` (string)
    Un identificador único para el grupo, que suele utilizarse para referenciarlo en solicitudes de API o en sistemas externos.
    Example: "exclusive"

  - `items.groups.item_order_in_group` (integer)
    Posición del artículo dentro del grupo, que se emplea para determinar su orden de visualización.
Este campo solamente se incluye en la respuesta si se solicita mediante el parámetro de consulta additional_fields[].
    Example: 1

  - `items.groups.name` (string)
    Nombre del grupo.
    Example: "Exclusive"

  - `items.has_keys` (boolean)
    Si es true, la clave del juego tiene claves para la venta.

  - `items.image_url` (string)
    URL de la imagen.
    Example: "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png"

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

  - `items.is_pre_order` (boolean)
    Si es true, la clave del juego está reservada y la fecha de lanzamiento no ha pasado.
    Example: true

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

  - `items.periods` (array)
    Periodo de venta del artículo.

  - `items.periods.date_from` (string,null)
    Fecha en la que el artículo especificado estará disponible para la venta.
    Example: "2020-08-11T10:00:00+03:00"

  - `items.periods.date_until` (string,null)
    Fecha en la que el artículo especificado dejará de estar disponible para la venta. Puede ser null.
    Example: "2020-08-11T20:00:00+03:00"

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

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

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

  - `items.price.currency` (string)
    Divisa del precio del artículo. Código de tres letras según [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).
    Example: "USD"

  - `items.release_date` (string,null)
    Fecha de lanzamiento de la clave del juego en formato ISO 8601.
    Example: "2020-08-11T10:00:00+03:00"

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

  - `items.type` (string)
    Tipo de artículo: game_key.
    Example: "game_key"

  - `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 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)
    SKU del artículo de la moneda virtual.
    Example: "vc_test"

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