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


  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 utilise un JWT utilisateur pour l'autorisation.
    Incluez le jeton dans l'en-tête Authorization au format suivant : Bearer <user_JWT>. Pour plus d'informations sur le JWT utilisateur, consultez le bloc Security pour cet appel.

Endpoint: GET /v2/project/{project_id}/user/reward_chain
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).

## Response 200 fields (application/json):

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

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

  - `items` (array)

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

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

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

  - `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.image_url` (string,null)
    URL de l'image

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

  - `items.date_start` (string)
    Date de début de la chaîne de récompenses.

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

  - `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.top_contributors` (array)

  - `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.top_contributors.contributed_amount` (integer)
    Montant des points de valeur gagnés par l'utilisateur.
    Example: 100

  - `items.value_point` (object)

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

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

  - `items.value_point.image_url` (string)
    URL de l'image

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

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

  - `items.value_point.amount` (integer)
    Montant des points 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.

  - `items.steps` (array)

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

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

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

  - `items.steps.image_url` (string)
    URL de l'image

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

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

  - `items.steps.reward.type` (string)
    Type d'objet.
    Example: "bundle"

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

  - `items.steps.reward.image_url` (string)
    URL de l'image

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

  - `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.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.en` (string,null)
    Example: "How to unlock rewards"

  - `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.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_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.popup_instruction.en` (string,null)
    Example: "You must be a clan member to get clan rewards. You join a clan when a clan member invites you to the clan, and you accept the invite. You can also create your own clan."

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

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

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

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

  - `items.popup_instruction.de` (string,null)
    Example: "Du musst ein Clanmitglied sein, um Clananreize zu erhalten. Du trittst einem Clan bei, wenn ein Clanmitglied dich einlädt, und du die Einladung annimmst. Du kannst auch deinen eigenen Clan erstellen."

  - `items.popup_instruction.es` (string,null)
    Example: "Debes ser miembro de un clan para obtener las recompensas del clan. Te unes a un clan cuando un miembro del clan te invita al clan y aceptas la invitación. También puedes crear tu propio clan."

  - `items.popup_instruction.fr` (string,null)
    Example: "Vous devez être membre d'un clan pour obtenir les récompenses du clan. Vous rejoignez un clan lorsque qu'un membre du clan vous invite au clan et que vous acceptez l'invitation. Vous pouvez également créer votre propre clan."

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

  - `items.popup_instruction.it` (string,null)
    Example: "Devi essere un membro del clan per ottenere le ricompense del clan. Ti unisci a un clan quando un membro del clan ti invita al clan e accetti l'invito. Puoi anche creare il tuo clan."

  - `items.popup_instruction.ja` (string,null)
    Example: "クランリワードを受け取るには、クランメンバーでなければなりません。 クランメンバーがあなたをクランに招待し、招待を受け入れると、クランに参加できます。 あなた自身のクランを作成することもできます。"

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

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

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

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

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

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

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

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

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

  - `items.popup_image_url` (string,null)
    Image pour la fenêtre contextuelle de la chaîne de récompenses de clan.