# Lire les chaînes de récompenses de l'utilisateur actuel

Endpoint client. Récupère des informations sur les chaînes de récompenses de l'utilisateur actuel.

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 la valeur maximale sont de 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}/user/reward_chain
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).

## Response 200 fields (application/json):

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

  - `items` (array)

  - `items.clan_type` (string,null)
    Type de clan.
    Enum: "clan", "guild", "faction", "community", "team", "squad", "alliance", "association", "coalition", "union", "group", "civilizations", "dynasty", "order", "league", "brotherhood", "kingdom", "organization", "house", "empire", "tribe", "cartel", null

  - `items.date_end` (string,null)
    Date de fin de la promotion de chaîne de récompenses. Peut prendre la valeur null. Si date_end est défini sur null, la chaîne de récompenses sera illimitée dans le temps.
    Example: "2020-04-15T18:16:00+05:00"

  - `items.date_start` (string)
    Date de début de la chaîne de récompenses.
    Example: "2020-04-15T18:16:00+05:00"

  - `items.description` (string,null)
    Description de la chaîne de récompenses.
    Example: "Major weekly quest"

  - `items.image_url` (string,null)
    URL de l'image.
    Example: "https://image.example.com"

  - `items.long_description` (string,null)
    Description détaillée de la chaîne de récompenses.
    Example: "You can get a lot of additional items just by shopping during the week"

  - `items.name` (string)
    Nom de la chaîne de récompenses.
    Example: "Weekly quest"

  - `items.order` (integer)
    Définit l'ordre d'empilement.
    Example: 1

  - `items.popup_header` (object,null)
    Objet contenant les localisations de l'en-tête de la fenêtre contextuelle de la chaîne de récompenses de clan. [Code de langue](https://developers.xsolla.com/fr/doc/pay-station/features/localization/) à deux lettres minuscules.

  - `items.popup_header.ar` (string,null)

  - `items.popup_header.bg` (string,null)

  - `items.popup_header.cn` (string,null)

  - `items.popup_header.cs` (string,null)

  - `items.popup_header.de` (string,null)
    Example: "Wie man Belohnungen freischaltet"

  - `items.popup_header.en` (string,null)
    Example: "How to unlock rewards"

  - `items.popup_header.es` (string,null)
    Example: "Cómo desbloquear recompensas"

  - `items.popup_header.fr` (string,null)
    Example: "Comment débloquer des récompenses"

  - `items.popup_header.he` (string,null)

  - `items.popup_header.it` (string,null)
    Example: "Come sbloccare ricompense"

  - `items.popup_header.ja` (string,null)
    Example: "報酬をアンロックする方法"

  - `items.popup_header.ko` (string,null)

  - `items.popup_header.pl` (string,null)

  - `items.popup_header.pt` (string,null)

  - `items.popup_header.ro` (string,null)

  - `items.popup_header.ru` (string,null)

  - `items.popup_header.th` (string,null)

  - `items.popup_header.tr` (string,null)

  - `items.popup_header.tw` (string,null)

  - `items.popup_header.vi` (string,null)

  - `items.popup_image_url` (string,null)
    Image pour la fenêtre contextuelle de la chaîne de récompenses de clan.
    Example: "https://image.example.com"

  - `items.popup_instruction` (object,null)
    Objet contenant les localisations des instructions de la fenêtre contextuelle de la chaîne de récompenses de clan. [Code de langue](https://developers.xsolla.com/fr/doc/pay-station/features/localization/) à deux lettres minuscules.

  - `items.recurrent_schedule` (object,null)
    Période de réinitialisation récurrente de la chaîne de récompenses.

  - `items.recurrent_schedule.interval_type` (any)

  - `items.recurrent_schedule.reset_next_date` (integer)
    Date et heure calculées auxquelles la chaîne de récompenses sera réinitialisée la prochaine fois (horodatage Unix).  Par exemple, la réinitialisation de la chaîne de récompenses est prévue chaque mois à partir du 1er mars 2024 à 01:00 de Kuala Lumpur (GMT+8). La date et l'heure de la prochaine remise à zéro de la chaîne de récompenses est le 1er avril 2024 à 01:00 de Kuala Lumpur (GMT+8), soit le 31 mars 2024 17:00 GMT+0 ou 1711904400000 dans le format Unix Timestamp.  Exemple : 1711904400000

  - `items.reward_chain_id` (integer)
    ID de la chaîne de récompenses.
    Example: 9

  - `items.steps` (array)

  - `items.steps.is_claimed` (boolean)
    Détermine si la récompense d'étape est réclamée.

  - `items.steps.name` (string)
    Nom de l'étape.
    Example: "Level 1"

  - `items.steps.price` (object)

  - `items.steps.price.amount` (integer)
    Nombre de points de valeur qu'un utilisateur réclame pour l'étape.
    Example: 100

  - `items.steps.reward` (array)

  - `items.steps.reward.description` (string)
    Description de l'objet.
    Example: "Super box with items"

  - `items.steps.reward.name` (string)
    Nom de l'objet.
    Example: "Super box"

  - `items.steps.reward.quantity` (integer)
    Quantité de l'objet.
    Example: 2

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

  - `items.steps.step_id` (integer)
    ID de l'étape.
    Example: 10

  - `items.top_contributors` (array)

  - `items.top_contributors.contributed_amount` (integer)
    Montant des points de valeur gagnés par l'utilisateur.
    Example: 100

  - `items.top_contributors.name` (string)
    ID utilisateur transmis à Xsolla lors de l'autorisation. Cet ID utilisateur associe l'utilisateur à votre projet Xsolla Login et sert de pseudonyme. Si vous utilisez l'autorisation par [ID utilisateur](https://developers.xsolla.com/fr/solutions/web-shop/create-web-shop/set-up-authentication/?tabs=100-UserIDAuth&link=100-UserIDAuth), nous vous recommandons de passer le name paramètre dans [la réponse du webhook](https://developers.xsolla.com/fr/webhooks/operation/user-validation-in-webshop/). Ce paramètre contient le nom d'utilisateur utilisé comme pseudonyme.
    Example: "Rocket"

  - `items.value_point` (object)

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

  - `items.value_point.description` (string,null)
    Description du point de valeur.

  - `items.value_point.is_clan` (boolean)
    Détermine l'utilisation du point de valeur dans les chaînes de récompense de clan.
    Example: true

  - `items.value_point.long_description` (string,null)
    Description détaillée du point de valeur.

  - `items.value_point.name` (string)
    Nom du point de valeur.

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

  - `total_items_count` (integer)
    Nombre total de chaînes de récompenses dans le système.
    Example: 10