# Belohnungsketten des aktuellen Nutzers abrufen

Client-Endpunkt. Ruft die Belohnungsketten des aktuellen Nutzers ab.


Achtung
Bei allen Projekten ist die Anzahl der Artikel begrenzt, die Sie in der Antwort erhalten können. Der Standard- und Höchstwert beträgt 50 Artikel pro Antwort. Um pro Seite mehr Daten zu erhalten, verwenden Sie die Felder limit und offset.





  Hinweis
    Dieser API-Aufruf verwendet einen Benutzer-JWT zur Autorisierung.
    Fügen Sie den Token im Authorization-Header im folgenden Format ein: Bearer <user_JWT>. Weitere Informationen zum Benutzer-JWT finden Sie im Block Sicherheit dieses Aufrufs.

Endpoint: GET /v2/project/{project_id}/user/reward_chain
Version: 2.0.0
Security: XsollaLoginUserJWT

## Path parameters:

  - `project_id` (integer, required)
    Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt sowie in der Adressleiste des Browsers, wenn Sie im Kundenportal ein Projekt geöffnet haben. Die URL hat das folgende Format: https://publisher.xsolla.com//projects/.
    Example: 44056

## Query parameters:

  - `limit` (integer)
    Begrenzung der Elementanzahl auf der Seite.
    Example: 50

  - `offset` (integer)
    Elementnummer, aus der die Liste generiert wird (die Zählung beginnt bei 0).

## Response 200 fields (application/json):

  - `has_more` (boolean)
    Dient als Indikator dafür, dass weitere Seiten vorhanden sind.
    Example: true

  - `total_items_count` (integer)
    Gesamtzahl der Belohnungsketten im System.
    Example: 10

  - `items` (array)

  - `items.reward_chain_id` (integer)
    Belohnungsketten-ID.
    Example: 9

  - `items.name` (string)
    Name der Belohnungskette.
    Example: "Weekly quest"

  - `items.description` (string,null)
    Beschreibung der Belohnungskette.
    Example: "Major weekly quest"

  - `items.long_description` (string,null)
    Lange Beschreibung der Belohnungskette.
    Example: "You can get a lot of additional items just by shopping during the week"

  - `items.image_url` (string,null)
    Bild-URL.

  - `items.order` (integer)
    Definiert die Anordnungsreihenfolge.

  - `items.date_start` (string)
    Datum, an dem Ihre Belohnungskette beginnt.

  - `items.date_end` (string,null)
    Datum, an dem Ihre Belohungsketten-Aktion endet. Darf null sein. Ist für date_end der Wert null festgelegt, ist die Belohnungskette zeitlich unbegrenzt.

  - `items.clan_type` (string,null)
    Clan-Typ.
    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)
    Benutzer-ID, die während des Autorisierungsvorgangs an Xsolla gesendet wird. Die Benutzer-ID wird als Nickname angezeigt und dient dazu, den Nutzer mit Ihrem Xsolla-Login-Projekt zu verknüpfen. Wenn Sie die Nutzer per [Benutzer-ID](https://developers.xsolla.com/de/solutions/web-shop/create-web-shop/set-up-authentication/?tabs=100-UserIDAuth&link=100-UserIDAuth) autorisieren, empfehlen wir, den name Parameter in [der Webhook-Antwort](https://developers.xsolla.com/de/webhooks/operation/user-validation-in-webshop/) zu übermitteln. Dieser Parameter enthält den Nutzernamen, der als Nickname verwendet wird.
    Example: "Rocket"

  - `items.top_contributors.contributed_amount` (integer)
    Anzahl der vom Nutzer gesammelten Wertpunkte.
    Example: 100

  - `items.value_point` (object)

  - `items.value_point.sku` (string)
    Eindeutige ID des Wertpunkts.

  - `items.value_point.name` (string)
    Wertpunktname.

  - `items.value_point.image_url` (string)
    Bild-URL.

  - `items.value_point.description` (string,null)
    Beschreibung des Wertpunktes.

  - `items.value_point.long_description` (string,null)
    Lange Beschreibung des Wertpunkts.

  - `items.value_point.amount` (integer)
    Anzahl der Wertpunkte.

  - `items.value_point.is_clan` (boolean)
    Ob der Wertpunkt in Clan-Belohnungsketten verwendet wird.

  - `items.steps` (array)

  - `items.steps.step_id` (integer)
    Schritt-ID.
    Example: 10

  - `items.steps.name` (string)
    Schrittname.
    Example: "Level 1"

  - `items.steps.is_claimed` (boolean)
    Ob die Schrittbelohnung in Anspruch genommen wurden ist.

  - `items.steps.image_url` (string)
    Bild-URL.

  - `items.steps.price` (object)

  - `items.steps.price.amount` (integer)
    Wie viele Wertpunkte ein Nutzer benötigt, um den Schritt abzuschließen.
    Example: 100

  - `items.steps.reward` (array)

  - `items.steps.reward.sku` (string)
    Eindeutige Artikel-ID. Die SKU darf nur lateinische Klein- und Großbuchstaben, Ziffern, Punkte, Bindestriche und Unterstriche enthalten.

  - `items.steps.reward.name` (string)
    Artikelname.
    Example: "Super box"

  - `items.steps.reward.type` (string)
    Artikeltyp.
    Example: "bundle"

  - `items.steps.reward.description` (string)
    Artikelbeschreibung.
    Example: "Super box with items"

  - `items.steps.reward.image_url` (string)
    Bild-URL.

  - `items.steps.reward.quantity` (integer)
    Artikelmenge.
    Example: 2

  - `items.recurrent_schedule` (object,null)
    Wiederkehrender Reset-Zeitraum der Belohnungskette.

  - `items.recurrent_schedule.interval_type` (any)

  - `items.recurrent_schedule.reset_next_date` (integer)
    Berechnetes Datum samt Uhrzeit, an dem die Belohnungskette das nächste Mal zurückgesetzt wird (Unix-Zeitstempel). Beispiel: Die Belohnungskette wird monatlich zurückgesetzt, beginnend ab dem 1. März 2024 um 01:00 Uhr Kuala-Lumpur-Zeit (GMT+8). Das Datum samt Uhrzeit, an dem die Belohnungskette das nächste Mal zurückgesetzt wird, ist der 1. April 2024 um 01:00 Uhr Kuala-Lumpur-Zeit (GMT+8), was dem 31. März 2024 um 17:00 Uhr (GMT+0) bzw. „1711904400000“ im Unix-Zeitstempelformat entspricht. Beispiel: „1711904400000“

  - `items.popup_header` (object,null)
    Objekt mit lokalisierten Überschriften für das Tooltipp-Pop-up-Fenster einer Clan-Belohnungskette. [Sprachencode](https://developers.xsolla.com/de/doc/pay-station/features/localization/) bestehend aus zwei Kleinbuchstaben.

  - `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)
    Objekt mit lokalisierten Anweisungen für das Tooltipp-Pop-up-Fenster einer Clan-Belohnungskette. [Sprachencode](https://developers.xsolla.com/de/doc/pay-station/features/localization/) bestehend aus zwei Kleinbuchstaben.

  - `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)
    Bild für das Tooltipp-Pop-up-Fenster einer Clan-Belohnungskette.