# Lire une liste de packages de monnaie virtuelle

Récupère une liste de packages de monnaie virtuelle 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/virtual_currency/package
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":[],"bundle_type":"virtual_currency_package","content":[{"description":"Big Rocket - short description","image_url":"https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png","inventory_options":{"consumable":{"usages_count":1}},"name":"Big Rocket","quantity":100,"sku":"big_rocket","type":"virtual_currency"}],"description":"VC Short Package Description","groups":[],"image_url":"http://vc_package_image.png","is_free":false,"name":"VC Name first package","price":{"amount":"2.0000","amount_without_discount":"2.0000","currency":"USD"},"sku":"vc_package_1","type":"bundle","virtual_prices":[]},{"attributes":[],"bundle_type":"virtual_currency_package","content":[{"description":"description","image_url":"http://image.png","inventory_options":{"consumable":{"usages_count":1}},"name":"SHOTGUN FOR TRUE RAIDERS","quantity":200,"sku":"shotgun_raider","type":"virtual_currency"}],"description":"VC Short Package Description","groups":[],"image_url":"http://vc_package_image.png","is_free":false,"name":"VC Name third package","price":{"amount":"4.0000","amount_without_discount":"4.0000","currency":"USD"},"sku":"vc_package_3","type":"bundle","virtual_prices":[]}]

  - `items.attributes` (array)
    Liste des attributs et de leurs valeurs correspondantes pour le jeu.

Attention. Cette partie de la réponse n'est disponible que si vous envoyez le paramètre de requête additional_fields[]=attributes.

  - `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.bundle_type` (string)
    Type de lot : standard/virtual_currency_package.
    Example: "virtual_currency_package"

  - `items.content` (array)
    Contenu du package de monnaie virtuelle.
    Example: [{"description":"Big Rocket - short description","image_url":"https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png","inventory_options":{"consumable":{"usages_count":1}},"name":"Big Rocket","quantity":100,"sku":"big_rocket","type":"virtual_currency"}]

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

  - `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.inventory_options` (object)
    Définit les propriétés de l'objet d'inventaire.

  - `items.content.inventory_options.consumable` (object,null)
    Définit la propriété de consommabilité, s'il s'agit d'un objet consommable, ou null s'il s'agit d'un objet non consommable.

  - `items.content.inventory_options.consumable.usages_count` (integer,null)
    Nombre total d'utilisations restantes s'il s'agit d'un objet consommable, ou null s'il s'agit d'un objet non consommable.
    Example: 1

  - `items.content.inventory_options.expiration_period` (object,null)
    Définit la propriété d'expiration s'il s'agit d'un objet à durée limitée, ou null s'il s'agit d'un objet à durée illimitée.

  - `items.content.inventory_options.expiration_period.type` (string)
    Définit le type d'expiration de l'objet.
    Enum: "minute", "hour", "day", "week", "month", "year"

  - `items.content.inventory_options.expiration_period.value` (integer)
    Définit la valeur du délai d'expiration.
    Example: 1

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

  - `items.content.quantity` (integer)
    Quantité de la monnaie virtuelle 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, des tirets et des traits bas.
    Example: "big_rocket"

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

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

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

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

  - `items.is_free` (string)
    Si ce paramètre est défini sur true, l'objet est gratuit.
    Example: "false"

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

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

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

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

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

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

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

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

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

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

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

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