# Lire la liste des monnaies virtuelles

Récupère la liste des monnaies virtuelles au sein d'un projet à des fins d'administration.

NoteN'utilisez pas cet endpoint pour créer un catalogue de magasin.

Endpoint: GET /v2/project/{project_id}/admin/items/virtual_currency
Version: 2.0.0
Security: basicAuth

## 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).

## Response 200 fields (application/json):

  - `items` (array)

  - `items.attributes` (array)
    Liste des attributs.
    Example: [{"external_id":"attribute_external_id","name":{"de":"Attributname","en":"Attribute name"},"values":[{"external_id":"value_1","name":{"de":"wert 1","en":"value 1"}},{"external_id":"value_2","name":{"de":"wert 2","en":"value 2"}}]}]

  - `items.attributes.external_id` (string, required)
    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` (object)
    Objet contenant des versions localisées du nom de l'attribut. Les clés sont spécifiées selon la norme ISO 3166-1.
    Example: {"de":"Genre","en":"Genre"}

  - `items.attributes.values` (array, required)
    Example: [{"external_id":"value_1","name":{"de":"wert 1","en":"value 1"}},{"external_id":"value_2","name":{"de":"wert 2","en":"value 2"}}]

  - `items.attributes.values.external_id` (string, required)
    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` (object, required)
    Objet contenant des versions localisées du nom de la valeur. Les clés sont spécifiées selon la norme ISO 3166-1.
    Example: {"de":"Strategie","en":"Strategy"}

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

  - `items.description` (object,null)
    Conteneur objet contenant les localisations de la description 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.groups` (array)
    Groupes auxquels l'objet appartient.
    Example: [{"external_id":"horror","name":{"en":"Horror"}}]

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

  - `items.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.image_url` (string)

  - `items.is_enabled` (boolean)

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

  - `items.is_hard` (boolean)

  - `items.is_show_in_store` (boolean)

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

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

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

  - `items.limits.per_item.reserved` (integer)

  - `items.limits.per_item.sold` (integer)

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

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

  - `items.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.limits.per_user.total` (integer)
    Nombre maximal d'objets qu'un utilisateur unique peut acheter.

  - `items.limits.recurrent_schedule` (object,null)
    Délai d'actualisation des limites.

  - `items.limits.recurrent_schedule.per_user` (object,null)
    Délai d'actualisation des limites pour un utilisateur.

  - `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 de l'objet, telles que des captures d'écran, des vidéos de gameplay, etc.
    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.name` (object,null)
    Conteneur objet contenant les localisations du nom 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.order` (integer)
    Définit l'ordre d'empilement.
    Example: 1

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

  - `items.periods.date_from` (string,null)
    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.prices` (array)
    Example: [{"amount":10.5,"country_iso":"US","currency":"USD","is_default":true,"is_enabled":true}]

  - `items.prices.amount` (number, required)
    Montant.
    Example: 10.5

  - `items.prices.country_iso` (string,null)
    Pays où ce prix est disponible. Code à deux lettres selon la norme [ISO 3166-1 alpha 2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
    Example: "US"

  - `items.prices.currency` (string, required)
    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.prices.is_default` (boolean)
    Example: true

  - `items.regions` (array)

  - `items.regions.id` (integer)
    Example: 1

  - `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: "booster_mega_1"

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

  - `items.vc_prices` (array)
    Example: [{"amount":10,"is_default":true,"sku":"com.xsolla.gold_1"}]

## Response 401 fields (application/json):

  - `errorCode` (integer)
    Example: 1020

  - `errorMessage` (string)
    Example: "[0401-1020]: Error in Authentication method occurred"

  - `statusCode` (integer)
    Example: 401