# Lire la liste des jeux qu'un utilisateur détient

Récupère la liste des jeux que l'utilisateur détient. La réponse contiendra un tableau de jeux qu'un utilisateur spécifique détient.


  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}/entitlement
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).

  - `sandbox` (integer)
    Quel type de droits doit être renvoyé. Si le paramètre est défini sur 1, les droits reçus par l'utilisateur en mode bac à sable sont renvoyés. Si le paramètre n'est pas passé ou est défini sur 0, les droits reçus par l'utilisateur en mode de production sont renvoyés.

  - `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 attributes.

## Response 200 fields (application/json):

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

  - `total_items_count` (integer)
    Nombre total d'objets dans le système.

  - `items` (array)

  - `items.name` (string)
    Nom du package de jeu.

  - `items.description` (string)
    Description du jeu.

  - `items.project_id` (integer)
    ID de projet. Ce paramètre se trouve dans le [Compte éditeur](https://publisher.xsolla.com/) à côté du nom du projet.

  - `items.game_sku` (string)
    ID unique du package de clés.

  - `items.drm` (string)
    ID unique du DRM.
    Enum: "steam", "playstation", "xbox", "uplay", "origin", "drmfree", "gog", "epicgames", "nintendo_eshop", "discord_game_store", "oculus", "rockstar", "viveport", "stadia"

  - `items.image_url` (string)
    URL de l'image. Pour garantir un affichage correct et un chargement rapide dans l'interface de paiement, consultez les recommandations suivantes pour les images et les URL :Formats pris en charge : WebP (recommandé), PNG, JPG.Taille du fichier : ≤ 50 Kb (WebP) ou ≤ 150 Kb (PNG et JPG).Dimensions : 280 x 280 px.Espace colorimétrique : sRGB.Protocole : HTTPS avec mise en cache longue durée pour les URL versionnées.

  - `items.is_pre_order` (boolean)
    Détermine si le jeu est en pré-commande.

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

## Response 401 fields (application/json):

  - `statusCode` (integer)
    Example: 401

  - `errorCode` (integer)
    Example: 1020

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