# Obtener la lista de claves del juego por grupo especificado

Obtiene una lista de claves del juego del grupo especificado 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/game/key/group/{external_id}
Version: 1.0.0
Security: AuthForClient

## Path parameters:

  - `project_id` (integer, required)
    ID 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)
    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":{"$ref":"#/components/examples/client-attribute-game-horror/Catalog_value"},"description":"Game description","drm_name":"Steam","drm_sku":"steam","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","price":{"amount":"30.5","amount_without_discount":"30.5","currency":"USD"},"release_date":"2020-08-11T10:00:00+03:00","sku":"game_1","type":"game_key","virtual_prices":[]},{"attributes":{"$ref":"#/components/examples/client-attribute-game-horror/Catalog_value"},"description":"Game description","drm_name":"Steam","drm_sku":"steam","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","price":{"amount":"30.5","amount_without_discount":"30.5","currency":"USD"},"sku":"game_2","type":"game_key","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: "Game description"

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

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

  - `items.groups` (array)
    Grupos a los que pertenece el artículo.
    Example: [{"external_id":"all","name":"All games"},{"external_id":"Xsolla","name":"Xsolla game"}]

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

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

  - `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.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)
    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.release_date` (string)
    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 código de un artículo (SKU) solo puede contener caracteres alfanuméricos latinos en minú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 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"