# Lire une liste de lots

Récupère une liste de lots 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 maximale est de 50 objets par réponse.  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/bundle
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)

  - `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.bundle_type` (string)
    Type de lot. Utilisez standard pour créer un lot contenant des objets et spécifiez les UGS des objet inclus.
Utilisez partner_side_content pour créer un lot vide auquel vous ajouterez des objets de votre côté via un [webhook](https://developers.xsolla.com/fr/webhooks/operation/personalized-partner-catalog/). Ce type est réservé à la [Personnalisation du catalogue côté partenaire](https://developers.xsolla.com/fr/doc/shop-builder/features/personalization/#guides_personalization_on_partner_side).
    Enum: "standard", "partner_side_content"

  - `items.can_be_bought` (boolean)
    Si true, l'utilisateur peut acheter l'objet.
    Example: true

  - `items.content` (array)
    Contenu du lot.
    Example: [{"attributes":[],"description":"Big Rocket - short description.","groups":[],"image_url":"https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png","is_free":false,"name":"Big Rocket","price":{"amount":"10.99","amount_without_discount":"10.99","currency":"USD"},"quantity":100,"sku":"com.xsolla.big_rocket_1","type":"virtual_currency"}]

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

  - `items.content.groups` (array)
    Groupes auxquels l'objet appartient.
    Example: [{"external_id":"horror","name":{"en":"Horror"}}]

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

  - `items.content.groups.name` (object)
    Nom de l'objet. Doit comprendre des paires clé/valeur
où la clé est une région au format "^[a-z]{2}", la valeur est une chaîne.
    Example: {"de":"Horror","en":"Horror"}

  - `items.content.image_url` (string)
    URL de l'image.
    Example: "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png"

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

  - `items.content.limits` (object,null)
    Limites d'objets.

  - `items.content.limits.per_item` (object,null)
    Informations sur les limites pour un objet.

  - `items.content.limits.per_item.available` (integer)
    Nombre d'objets restants que tous les utilisateurs peuvent acheter.
    Example: 3

  - `items.content.limits.per_item.total` (integer)
    Nombre maximal d'objets que tous les utilisateurs peuvent acheter.
    Example: 5

  - `items.content.limits.per_user` (object,null)
    Limites d'objets pour un utilisateur.

  - `items.content.limits.per_user.available` (integer)
    Nombre d'objets restants que l'utilisateur actuel peut acheter.
    Example: 3

  - `items.content.limits.per_user.limit_exceeded_visibility` (string)
    Détermine la visibilité de l'objet dans le catalogue une fois la limite d'achat atteinte, jusqu'à la prochaine réinitialisation de la limite.

S'applique aux objets pour lesquels des réinitialisations de limite récurrentes sont configurées dans le tableau recurrent_schedule.

Si aucune réinitialisation de limite n'est configurée, l'objet n'apparaît plus dans le catalogue après l'atteinte de la limite d'achat, quelle que soit la valeur de limit_exceeded_visibility.
    Enum: "show", "hide"

  - `items.content.limits.per_user.recurrent_schedule` (object)
    Délai d'actualisation récurrent des limites d'un objet pour un utilisateur.

  - `items.content.limits.per_user.recurrent_schedule.interval_type` (string)
    Type de délai d'actualisation récurrent.
    Enum: "daily", "weekly", "monthly", "hourly"

  - `items.content.limits.per_user.recurrent_schedule.reset_next_date` (integer)
    Date et heure de la réinitialisation des limites (horodatage Unix).
    Example: 1677553200

  - `items.content.limits.per_user.total` (integer)
    Nombre maximal d'objets qu'un utilisateur unique peut acheter.
    Example: 5

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

  - `items.content.price` (object,null)
    Prix de l'objet.

  - `items.content.price.amount` (string)
    Prix de l'objet avec remise.
    Example: "100.99"

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

  - `items.content.price.currency` (string)
    Devise du prix de l'article. Code à trois lettres selon [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). Consultez la documentation pour obtenir des informations détaillées sur les devises [prises en charge par Xsolla](https://developers.xsolla.com/fr/doc/pay-station/references/supported-currencies/).
    Example: "USD"

  - `items.content.quantity` (integer)
    Quantité de l'objet dans le package.
    Example: 250

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

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

  - `items.content.virtual_item_type` (string)
    Type d'objet virtuel.
    Enum: "consumable", "non_consumable", "non_renewing_subscription"

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

  - `items.content.virtual_prices.amount` (integer)
    Prix de l'objet en monnaie virtuelle avec remise.
    Example: 100

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

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

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

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

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

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

  - `items.custom_attributes` (object)
    Un JSON contenant les attributs de l'objet et leurs valeurs.

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

  - `items.long_description` (object,null)
    Conteneur objet contenant les localisations de la description complète de l'objet (item). Il accepte deux formats de codes de langue : les codes à deux lettres minuscules (comme en) et les codes régionaux à cinq caractères (comme en-US). Les deux formats sont valides en entrée, mais les réponses utilisent toujours le format à deux lettres. Si les deux variantes sont fournies pour une même langue (par exemple, en et en-US), seule la dernière est conservée. Consultez la [documentation](/fr/doc/shop-builder/references/supported-languages/) pour la liste complète des langues prises en charge.

  - `items.media_list` (array)
    Ressources supplémentaires du lot.
    Example: [{"type":"image","url":"https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg"}]

  - `items.media_list.type` (string)
    Type de média : image/video.
    Enum: "image", "video"

  - `items.media_list.url` (string)
    Fichier de ressources.
    Example: "https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg"

  - `items.order` (integer)
    Ordre de priorité des lots dans la liste.
    Example: 1

  - `items.periods` (array,null)
    Période de vente d'objets.

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

  - `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.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: "bundle_1"

  - `items.total_content_price` (object,null)
    Somme des prix du contenu du lot.

  - `items.total_content_price.amount` (string)
    Somme des prix du contenu du lot avec remise.
    Example: "100.99"

  - `items.total_content_price.amount_without_discount` (string)
    Somme des prix du contenu du lot.
    Example: "100.99"

  - `items.total_content_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.type` (string)
    Type d'objet.
    Example: "bundle"

  - `items.vp_rewards` (array)
    Récompense en points de valeur pour l'objet.

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

  - `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.vp_rewards.name` (string)
    Nom du point de valeur.

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