# Belohnungsketten des aktuellen Nutzers abrufen

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

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

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

  - `items` (array)

  - `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.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.
    Example: "2020-04-15T18:16:00+05:00"

  - `items.date_start` (string)
    Datum, an dem Ihre Belohnungskette beginnt.
    Example: "2020-04-15T18:16:00+05:00"

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

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

  - `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.name` (string)
    Name der Belohnungskette.
    Example: "Weekly quest"

  - `items.order` (integer)
    Definiert die Anordnungsreihenfolge.
    Example: 1

  - `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.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)
    Bild für das Tooltipp-Pop-up-Fenster einer Clan-Belohnungskette.
    Example: "https://image.example.com"

  - `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.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.reward_chain_id` (integer)
    Belohnungsketten-ID.
    Example: 9

  - `items.steps` (array)

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

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

  - `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.description` (string)
    Artikelbeschreibung.
    Example: "Super box with items"

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

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

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

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

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

  - `items.top_contributors` (array)

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

  - `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.value_point` (object)

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

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

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

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

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

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

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