# 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 pouvant être retourné dans une réponse. La valeur par défaut et maximale est de 50 objets par réponse. Pour récupérer davantage de données page par page, utilisez les champs limit et offset. Note Cet appel API renvoie des données génériques du catalogue des objets lorsqu'il est utilisé sans autorisation. Utilisez l'autorisation pour récupérer des données utilisateur personnalisées, telles que les limites et les promotions associées à l'objet. Pour ce faire, passez le JWT utilisateur dans l'en-tête Authorization. Pour plus d'informations sur le JWT utilisateur, consultez le bloc Security pour cet appel. Endpoint: GET /v2/project/{project_id}/items/game Version: 2.0.0 Security: XsollaLoginUserJWT ## Path parameters: - `project_id` (integer, required) ID du projet. Vous trouverez ce paramètre dans le Compte éditeur, à côté du nom du projet, ainsi que dans l'URL affichée dans la barre d'adresse du navigateur lorsque vous utilisez ce projet. L'URL présente le format suivant : https://publisher.xsolla.com//projects/. 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 ISO 639-1 à deux lettres en minuscules (par exemple, en). Les codes régionaux à cinq caractères (par exemple, en-US) sont pris en charge dans les champs localisables tels que name et description, mais sont normalisés en codes à deux lettres dans les réponses. La liste complète des langues prises en charge est disponible dans la documentation. - `additional_fields[]` (array) Champs supplémentaires à inclure dans la réponse. Par défaut, ces champs ne sont pas renvoyés. Passez les valeurs requises pour les inclure. 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. - `items` (array) Example: [{"sku":"com.xsolla.game_1","name":"Game name","groups":[{"external_id":"all","name":"All games"},{"external_id":"Xsolla","name":"Xsolla games"}],"type":"unit","unit_type":"game","description":"Game description","image_url":"https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png","attributes":[{"external_id":"genre","name":"Genre","values":[{"external_id":"23fda05111c125608af8f1fa0e99db45a10ea1cc","value":"Horror"}]}],"promotions":[],"unit_items":[{"sku":"com.xsolla.game_key_01","type":"game_key","is_free":false,"price":{"amount":"30.5","amount_without_discount":"30.5","currency":"USD"},"virtual_prices":[],"can_be_bought":true,"drm_name":"Steam","drm_sku":"steam_key_1","has_keys":true,"is_pre_order":true,"release_date":"2020-08-11T10:00:00+03:00","promotions":[],"periods":[{"date_from":"2020-08-11T10:00:00+03:00","date_until":"2020-08-11T20:00:00+03:00"}]},{"sku":"com.xsolla.game_key_02","type":"game_key","is_free":false,"price":{"amount":"30.5","amount_without_discount":"30.5","currency":"USD"},"virtual_prices":[],"can_be_bought":true,"drm_name":"Origin","drm_sku":"origin_key_1","has_keys":false,"is_pre_order":false,"release_date":null,"promotions":[],"periods":[]}]},{"sku":"com.xsolla.game_2","name":"Game name","groups":[{"external_id":"all","name":"All games"}],"type":"unit","unit_type":"game","description":"Game description","image_url":"https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png","attributes":[{"external_id":"OS","name":"OS","values":[{"external_id":"9d5c5efb7c0f00a00fe4e3583f1215b0050bc723","value":"Windows"}]}],"promotions":[],"unit_items":[{"sku":"com.xsolla.game_key_01","type":"game_key","is_free":false,"price":{"amount":"30.5","amount_without_discount":"30.5","currency":"USD"},"virtual_prices":[],"can_be_bought":true,"drm_name":"Steam","drm_sku":"steam_key_2","has_keys":false,"is_pre_order":false,"release_date":null,"promotions":[],"periods":[{"date_from":null,"date_until":"2020-08-11T20:00:00+03:00"}]}]}] - `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.name` (string) Nom de l'objet. Example: "Game name" - `items.groups` (array) Groupes auxquels l'objet appartient. - `items.groups.external_id` (string) [ID externe du groupe d'objets](/fr/api/catalog/item-groups-admin/admin-create-item-group#item-groups-admin/admin-create-item-group/t=request&path=external_id) défini lors de sa création. Example: "exclusive" - `items.groups.name` (string) Nom du groupe. Example: "Exclusive" - `items.groups.item_order_in_group` (integer) Position de l'objet dans le groupe, qui détermine son ordre d'affichage. Renvoyée uniquement si demandée via le paramètre de requête additional_fields[]. Example: 1 - `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 external_id ne peut comprendre que des caractères alphanumériques latins minuscules et majuscules, des tirets et des traits bas. - `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. - `items.attributes.values.value` (string) Valeur de l'attribut. Example: "Strategy" - `items.type` (string) Type d'objet : virtual_good/virtual_currency/bundle/physical_good/unit. Example: "unit" - `items.unit_type` (string) Type d'unité : game. Example: "game" - `items.description` (string) Description de l'objet. Example: "Game description" - `items.image_url` (string) URL de l'image Example: "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png" - `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.name` (string) - `items.promotions.date_start` (string,null) - `items.promotions.date_end` (string,null) - `items.promotions.discount` (object,null) - `items.promotions.discount.percent` (string,null) - `items.promotions.discount.value` (string,null) - `items.promotions.bonus` (array) - `items.promotions.bonus.sku` (string) - `items.promotions.bonus.quantity` (integer) - `items.promotions.bonus.type` (string) Type d'objet bonus. Enum: "virtual_good", "virtual_currency", "bundle", "physical_good", "game_key", "nft" - `items.promotions.bonus.name` (string) Nom de l'objet bonus. Non disponible pour le type d'objet bonus physical_good. - `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.bundle_type` (string) Type de lot bonus. Disponible uniquement pour le type d'objet bundle. Enum: "standard", "virtual_currency_package" - `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.unit_items` (array) - `items.unit_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.unit_items.type` (string) Type d'objet : game_key. Example: "game_key" - `items.unit_items.is_free` (boolean) Détermine la gratuité de l'objet. - `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'objet. Code à trois lettres selon [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). Example: "USD" - `items.unit_items.virtual_prices` (array) Prix virtuels. - `items.unit_items.virtual_prices.amount` (integer) Prix de l'objet en monnaie virtuelle. Example: 100 - `items.unit_items.virtual_prices.amount_without_discount` (integer) Prix de l'objet en monnaie virtuelle, hors remise. Il correspond toujours à amount, car les remises ne s'appliquent pas aux prix en monnaie virtuelle. Example: 200 - `items.unit_items.virtual_prices.sku` (string) UGS de la monnaie virtuelle. Example: "vc_gold" - `items.unit_items.virtual_prices.is_default` (boolean) Détermine s'il s'agit du prix par défaut en monnaie virtuelle. Example: true - `items.unit_items.virtual_prices.image_url` (string,null) URL de l'image de la monnaie virtuelle. Example: "http://image.png" - `items.unit_items.virtual_prices.name` (string) Nom de la monnaie virtuelle. Example: "Gold" - `items.unit_items.virtual_prices.type` (string) Type d'objet. Pour la monnaie virtuelle, il s'agit de virtual_currency. Example: "virtual_currency" - `items.unit_items.virtual_prices.description` (string,null) Description de la monnaie virtuelle. Example: "In-game currency used to purchase weapons and upgrades" - `items.unit_items.can_be_bought` (boolean) Si true, l'utilisateur peut acheter l'objet. - `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_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.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.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.unit_items.promotions.name` (string) - `items.unit_items.promotions.date_start` (string,null) - `items.unit_items.promotions.date_end` (string,null) - `items.unit_items.promotions.discount` (object,null) - `items.unit_items.promotions.discount.percent` (string,null) - `items.unit_items.promotions.discount.value` (string,null) - `items.unit_items.promotions.bonus` (array) - `items.unit_items.promotions.bonus.sku` (string) - `items.unit_items.promotions.bonus.quantity` (integer) - `items.unit_items.promotions.bonus.type` (string) Type d'objet bonus. Enum: "virtual_good", "virtual_currency", "bundle", "physical_good", "game_key", "nft" - `items.unit_items.promotions.bonus.name` (string) Nom de l'objet bonus. Non disponible pour le type d'objet bonus physical_good. - `items.unit_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.unit_items.promotions.bonus.bundle_type` (string) Type de lot bonus. Disponible uniquement pour le type d'objet bundle. Enum: "standard", "virtual_currency_package" - `items.unit_items.promotions.limits` (object) - `items.unit_items.promotions.limits.per_user` (object) - `items.unit_items.promotions.limits.per_user.available` (integer) - `items.unit_items.promotions.limits.per_user.total` (integer) - `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.vp_rewards` (array) Liste des récompenses en points de valeur associées à cet objet. - `items.unit_items.vp_rewards.item_id` (integer) Internal ID unique de l'objet. - `items.unit_items.vp_rewards.sku` (string) ID unique du point de valeur. - `items.unit_items.vp_rewards.amount` (integer) Montant des points de valeur. - `items.unit_items.vp_rewards.name` (string) Nom du point de valeur. - `items.unit_items.vp_rewards.image_url` (string) URL de l'image - `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. - `items.unit_items.loyalty_rewards` (array) Points de fidélité reçus par l'utilisateur en récompense de l'achat de l'objet. - `items.unit_items.loyalty_rewards.name` (string) Nom des points de fidélité. - `items.unit_items.loyalty_rewards.sku` (string) UGS des points de fidélité. Transmettez cette valeur dans le paramètre loyalty_point_sku des autres appels API, par exemple lors de la création d'une commande payée avec des points de fidélité. - `items.unit_items.loyalty_rewards.description` (string) Description des points de fidélité. - `items.unit_items.loyalty_rewards.image_url` (string,null) URL de l'image - `items.unit_items.loyalty_rewards.amount` (integer) Nombre de points de fidélité reçus par l'utilisateur pour l'achat de l'objet. - `items.unit_items.loyalty_prices` (array) Nombre de points de fidélité nécessaires pour acheter l'objet. - `items.unit_items.loyalty_prices.name` (string) Nom des points de fidélité. - `items.unit_items.loyalty_prices.sku` (string) UGS des points de fidélité. Transmettez cette valeur dans le paramètre loyalty_point_sku des autres appels API, par exemple lors de la création d'une commande payée avec des points de fidélité. - `items.unit_items.loyalty_prices.description` (string) Description des points de fidélité. - `items.unit_items.loyalty_prices.image_url` (string,null) URL de l'image - `items.unit_items.loyalty_prices.amount` (integer) Prix de l'objet en points de fidélité spécifiés.