# Lire une liste de jeux

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

AttentionTous 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.   RemarqueL'utilisation des appels API du catalogue des objets est disponible sans autorisation, mais pour obtenir un catalogue personnalisé, vous devez passer le JWT utilisateur dans l'en-tête d'autorisation.

Endpoint: GET /v2/project/{project_id}/items/game
Version: 2.0.0
Security: XsollaLoginUserJWT

## Path parameters:

  - `project_id` (integer, required)
    ID de projet. Ce paramètre se trouve dans le Compte éditeur à côté du nom du 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 dé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)
    La liste des champs supplémentaires. Ces champs figureront dans la réponse si vous les envoyez dans votre requête.
    Enum: "media_list", "order", "long_description", "custom_attributes", "item_order_in_group"

  - `country` (string)
    Code pays à deux lettres majuscules selon la norme ISO 3166-1 alpha-2. Consultez la documentation pour obtenir des informations détaillées sur les pays pris en charge par Xsolla et le processus de détermination du pays.
    Example: "US"

  - `promo_code` (string)
    Code unique sensible à la casse. Comprend des lettres et des chiffres.
    Example: "WINTER2021"

  - `show_inactive_time_limited_items` (integer)
    Affiche les objets à durée limitée qui ne sont pas disponibles pour l'utilisateur. La période de validité de ces objets n'ayant pas commencé ou ayant déjà expiré.
    Example: 1

## Response 200 fields (application/json):

  - `has_more` (boolean)
    Utilisé pour indiquer qu'il y a plus de pages.
    Example: true

  - `items` (array)
    Example: [{"attributes":[{"external_id":"genre","name":"Genre","values":[{"external_id":"23fda05111c125608af8f1fa0e99db45a10ea1cc","value":"Horror"}]}],"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","promotions":[],"sku":"com.xsolla.game_1","type":"unit","unit_items":[{"can_be_bought":true,"drm_name":"Steam","drm_sku":"steam_key_1","has_keys":true,"is_free":false,"is_pre_order":true,"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"},"promotions":[],"release_date":"2020-08-11T10:00:00+03:00","sku":"com.xsolla.game_key_01","type":"game_key","virtual_prices":[]},{"can_be_bought":true,"drm_name":"Origin","drm_sku":"origin_key_1","has_keys":false,"is_free":false,"is_pre_order":false,"periods":[],"price":{"amount":"30.5","amount_without_discount":"30.5","currency":"USD"},"promotions":[],"release_date":null,"sku":"com.xsolla.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","promotions":[],"sku":"com.xsolla.game_2","type":"unit","unit_items":[{"can_be_bought":true,"drm_name":"Steam","drm_sku":"steam_key_2","has_keys":false,"is_free":false,"is_pre_order":false,"periods":[{"date_from":null,"date_until":"2020-08-11T20:00:00+03:00"}],"price":{"amount":"30.5","amount_without_discount":"30.5","currency":"USD"},"promotions":[],"release_date":null,"sku":"com.xsolla.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.
    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 unique de l'attribut. Le external_id ne peut comprendre que des caractères alphanumériques latins minuscules et majuscules, 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":"exclusive","name":"Exclusive"}]

  - `items.groups.external_id` (string)
    Identifiant unique du groupe, généralement utilisé pour le référencer dans les requêtes API ou les systèmes externes.
    Example: "exclusive"

  - `items.groups.item_order_in_group` (integer)
    Position de l'objet dans le groupe, utilisée pour déterminer son ordre d'affichage.
Ce champ n'est inclus dans la réponse que si elle est demandée via le paramètre de requête additional_fields[].
    Example: 1

  - `items.groups.name` (string)
    Nom du groupe.
    Example: "Exclusive"

  - `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.promotions` (array)
    Promotions appliquées à des objets spécifiques du panier. Le tableau est renvoyé dans les cas suivants :

* Une promotion par réduction est configurée pour un objet spécifique.

* Un code promo avec le paramètre Discount on selected items est appliqué.

Si aucune promotion de ce type n'est appliquée, un tableau vide est renvoyé.

  - `items.promotions.bonus` (array)

  - `items.promotions.bonus.bundle_type` (string)
    Type de lot bonus. Disponible uniquement pour le type d'objet bundle.
    Enum: "standard", "virtual_currency_package"

  - `items.promotions.bonus.image_url` (string)
    URL de l'image de l'objet bonus. Non disponible pour le type d'objet bonus physical_good.

  - `items.promotions.bonus.name` (string)
    Nom de l'objet bonus. Non disponible pour le type d'objet bonus physical_good.

  - `items.promotions.bonus.quantity` (integer)

  - `items.promotions.bonus.sku` (string)

  - `items.promotions.bonus.type` (string)
    Type d'objet bonus.
    Enum: "virtual_good", "virtual_currency", "bundle", "physical_good", "game_key", "nft"

  - `items.promotions.date_end` (string,null)

  - `items.promotions.date_start` (string,null)

  - `items.promotions.discount` (object,null)

  - `items.promotions.discount.percent` (string,null)

  - `items.promotions.discount.value` (string,null)

  - `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.promotions.name` (string)

  - `items.sku` (string)
    ID unique de l'objet. L'UGS ne peut comprendre que des caractères alphanumériques latins minuscules et majuscules, 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.can_be_bought` (boolean)
    Si true, l'utilisateur peut acheter l'objet.
    Example: true

  - `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 et majuscules, 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.periods` (array,null)
    Période de vente d'objets.

  - `items.unit_items.periods.date_from` (string)
    Date de mise en vente de l'objet spécifié.
    Example: "2020-08-11T10:00:00+03:00"

  - `items.unit_items.periods.date_until` (string,null)
    Date de retrait de la vente de l'objet spécifié. Peut prendre la valeur null.
    Example: "2020-08-11T20:00:00+03:00"

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

  - `items.unit_items.price.amount` (string)
    Prix de l'objet avec remise.
    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 du prix de l'article. Code à trois lettres selon [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).
    Example: "USD"

  - `items.unit_items.release_date` (string,null)
    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_items.vp_rewards` (array)
    Récompense en points de valeur pour l'objet.

  - `items.unit_items.vp_rewards.amount` (integer)
    Montant des points de valeur.

  - `items.unit_items.vp_rewards.is_clan` (boolean)
    Détermine l'utilisation du point de valeur dans les chaînes de récompense de clan.
    Example: true

  - `items.unit_items.vp_rewards.item_id` (integer)
    Internal ID unique de l'objet.
    Example: 1

  - `items.unit_items.vp_rewards.name` (string)
    Nom du point de valeur.

  - `items.unit_items.vp_rewards.sku` (string)
    ID unique du point de valeur.

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