# Lire une liste de jeux

Récupère une liste de jeux pour la constitution d'un catalogue.

Attention. Tous les projets sont soumis à une limite de nombre d'objets que vous pouvez obtenir dans la réponse. La valeur par défaut et la valeur maximale sont 50 éléments par réponse. Pour obtenir plus de données page par page, utilisez les champs limit et offset.

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

## Path parameters:

  - `project_id` (integer, required)
    ID de projet.
    Example: 44056

## Query parameters:

  - `limit` (integer)
    Nombre maximal d'éléments sur une page.
    Example: 50

  - `offset` (integer)
    Numéro de l'élément à partir duquel la liste est générée (le compte commence à 0).

  - `locale` (string)
    Langue de la réponse. Code de langue à deux lettres minuscules selon la norme ISO 639-1.

  - `additional_fields[]` (array)
    Liste des champs supplémentaires. Ces champs figureront dans la réponse si vous les envoyez dans votre requête. Champs disponibles media_list, order et long_description.

  - `country` (string)
    Pays pour la détermination des prix régionaux et des restrictions pour le catalogue. Code pays à deux lettres majuscules selon la norme ISO 3166-1 alpha-2. Si vous ne spécifiez pas explicitement le pays, il sera déterminé en fonction de l'adresse IP de l'utilisateur.

## Response 200 fields (application/json):

  - `items` (array)
    Example: [{"attributes":{"$ref":"#/components/examples/client-attribute-game/Catalog_value"},"description":"Game description","groups":[{"external_id":"all","name":"All games"},{"external_id":"Xsolla","name":"Xsolla games"}],"image_url":"https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png","name":"Game name","sku":"game_1","type":"unit","unit_items":[{"drm_name":"Steam","drm_sku":"steam","has_keys":true,"is_free":false,"is_pre_order":true,"price":{"amount":"30.5","amount_without_discount":"30.5","currency":"USD"},"release_date":"2020-08-11T10:00:00+03:00","sku":"game_key_01","type":"game_key","virtual_prices":[]},{"drm_name":"Origin","drm_sku":"origin","has_keys":false,"is_free":false,"is_pre_order":false,"price":{"amount":"30.5","amount_without_discount":"30.5","currency":"USD"},"sku":"game_key_02","type":"game_key","virtual_prices":[]}],"unit_type":"game"},{"attributes":[{"external_id":"OS","name":"OS","values":[{"external_id":"9d5c5efb7c0f00a00fe4e3583f1215b0050bc723","value":"Windows"}]}],"description":"Game description","groups":[{"external_id":"all","name":"All games"}],"image_url":"https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png","name":"Game name","sku":"game_2","type":"unit","unit_items":[{"drm_name":"Steam","drm_sku":"steam","has_keys":false,"is_free":false,"is_pre_order":false,"price":{"amount":"30.5","amount_without_discount":"30.5","currency":"USD"},"sku":"game_key_01","type":"game_key","virtual_prices":[]}],"unit_type":"game"}]

  - `items.attributes` (array)
    Liste des attributs et de leurs valeurs correspondantes pour l'objet. Peut être utilisée pour le filtrage du catalogue.

  - `items.attributes.external_id` (string)
    ID unique de l'attribut. Le paramètre external_id ne peut comprendre que des caractères alphanumériques latins minuscules, des tirets et des traits bas.
    Example: "attribute_1"

  - `items.attributes.name` (string)
    Nom de l'attribut.
    Example: "Genre"

  - `items.attributes.values` (array)

  - `items.attributes.values.external_id` (string)
    ID unique de la valeur d'un attribut. Le external_id ne peut comprendre que des caractères alphanumériques latins minuscules, des tirets et des tirets bas.
    Example: "attribute_value"

  - `items.attributes.values.value` (string)
    Valeur de l'attribut.
    Example: "Strategy"

  - `items.description` (string)
    Description de l'objet.
    Example: "Game description"

  - `items.groups` (array)
    Groupes auxquels l'objet appartient.
    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.image_url` (string)
    URL de l'image.
    Example: "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png"

  - `items.name` (string)
    Nom de l'objet.
    Example: "Game name"

  - `items.sku` (string)
    ID unique de l'objet. L'UGS ne peut comprendre que des caractères alphanumériques latins minuscules, des points, des tirets et des traits bas.
    Example: "game_01"

  - `items.type` (string)
    Type d'objet : virtual_good/virtual_currency/bundle/physical_good/unit.
    Example: "unit"

  - `items.unit_items` (array)

  - `items.unit_items.drm_name` (string)
    Nom du DRM.
    Example: "Steam"

  - `items.unit_items.drm_sku` (string)
    ID unique du DRM. L'UGS ne peut comprendre que des caractères alphanumériques latins minuscules, des points, des tirets et des traits bas.
    Example: "steam"

  - `items.unit_items.has_keys` (boolean)
    Si true, le module Clés de jeu a des clés vendables.

  - `items.unit_items.is_free` (boolean)
    Si ce paramètre est défini sur true, l'objet est gratuit.

  - `items.unit_items.is_pre_order` (boolean)
    Si true, la clé de jeu est en pré-commande et la date de sortie n'est pas dépassée.
    Example: true

  - `items.unit_items.price` (object)
    Prix de l'objet.

  - `items.unit_items.price.amount` (string)
    Prix de l'objet réduit.
    Example: "2.9900"

  - `items.unit_items.price.amount_without_discount` (string)
    Prix de l'objet.
    Example: "2.9900"

  - `items.unit_items.price.currency` (string)
    Devise d'achat par défaut. Code de devise à trois lettres selon la norme [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).
    Example: "USD"

  - `items.unit_items.release_date` (string)
    Date de publication de la clé de jeu au format ISO 8601.
    Example: "2020-08-11T10:00:00+03:00"

  - `items.unit_items.type` (string)
    Type d'objet : game_key.
    Example: "game_key"

  - `items.unit_items.virtual_prices` (array)
    Prix virtuels.

  - `items.unit_items.virtual_prices.amount` (integer)
    Prix de l'objet réduit en monnaie virtuelle.
    Example: 100

  - `items.unit_items.virtual_prices.description` (string)
    Description de la monnaie virtuelle.
    Example: "Big Rocket - description"

  - `items.unit_items.virtual_prices.image_url` (string)
    Image de la monnaie virtuelle.
    Example: "http://image.png"

  - `items.unit_items.virtual_prices.is_default` (boolean)
    Indique si le prix est le prix par défaut de l'objet.
    Example: true

  - `items.unit_items.virtual_prices.name` (string)
    Nom de la monnaie virtuelle.
    Example: "SHOTGUN FOR TRUE RAIDERS"

  - `items.unit_items.virtual_prices.sku` (string)
    UGS de la monnaie virtuelle.
    Example: "vc_test"

  - `items.unit_items.virtual_prices.type` (string)
    Type de monnaie virtuelle.
    Example: "virtual_currency"

  - `items.unit_type` (string)
    Type d'unité : game.
    Example: "game"