# 現在のユーザーの報酬チェーンを取得する

クライアントエンドポイント。現在のユーザー報酬チェーンを取得します。


  注意
    すべてのプロジェクトには、応答で取得できるアイテム数に制限があります。デフォルトおよび最大値は1応答あたり50アイテムです。ページごとにデータを取得するには、制限とオフセットフィールドを使用してください。





  注意
    このAPIコールはユーザーJWTを使用して認証を行います。
    トークンはAuthorizationヘッダーへ次の形式でトークンを設定します：Bearer &lt;user_JWT&gt;。ユーザーJWTに関する詳細情報は、該当コールのセキュリティブロックで確認できます。

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

## Path parameters:

  - `project_id` (integer, required)
    プロジェクトID。このパラメータは、パブリッシャーアカウントのプロジェクト名の横、またはプロジェクトの作業中にブラウザのアドレスバーで確認できます。URLの形式は以下の通りです：https://publisher.xsolla.com//projects/。
    Example: 44056

## Query parameters:

  - `limit` (integer)
    ページでの要素数の制限。
    Example: 50

  - `offset` (integer)
    リストが生成される要素番号（カウントは0から始まります）。

## Response 200 fields (application/json):

  - `has_more` (boolean)
    ページ数がもっとあることを示す指標として使用されます。
    Example: true

  - `total_items_count` (integer)
    システム内の報酬チェーンの総数。
    Example: 10

  - `items` (array)

  - `items.reward_chain_id` (integer)
    報酬チェーンID。
    Example: 9

  - `items.name` (string)
    報酬チェーン名。
    Example: "Weekly quest"

  - `items.description` (string,null)
    報酬チェーンの説明。
    Example: "Major weekly quest"

  - `items.long_description` (string,null)
    報酬チェーンの長い説明。
    Example: "You can get a lot of additional items just by shopping during the week"

  - `items.image_url` (string,null)
    画像URL。

  - `items.order` (integer)
    配列順序を定義します。

  - `items.date_start` (string)
    報酬チェーンの開始日。

  - `items.date_end` (string,null)
    報酬チェープロモーションが終了する日付。「null」も可能です。date_endがnullの場合、報酬チェーンは時間制限がありません。

  - `items.clan_type` (string,null)
    クランタイプ。
    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。ユーザーIDは、ユーザーをエクソーラログインプロジェクトにリンクするために使用され、ニックネームとして表示されます。[ユーザーID](https://developers.xsolla.com/ja/solutions/web-shop/create-web-shop/set-up-authentication/?tabs=100-UserIDAuth&link=100-UserIDAuth)経由での認証を使用している場合は、[ウェブフック応答](https://developers.xsolla.com/ja/webhooks/operation/user-validation-in-webshop/)でnameパラメータを渡すことをお勧めします。このパラメータには、ニックネームとして使用されるユーザー名が含まれています。
    Example: "Rocket"

  - `items.top_contributors.contributed_amount` (integer)
    ユーザーが獲得したバリューポイントの額。
    Example: 100

  - `items.value_point` (object)

  - `items.value_point.sku` (string)
    一意のバリューポイントID。

  - `items.value_point.name` (string)
    バリューポイント名。

  - `items.value_point.image_url` (string)
    画像URL。

  - `items.value_point.description` (string,null)
    バリューポイントの説明。

  - `items.value_point.long_description` (string,null)
    バリューポイントの長い説明。

  - `items.value_point.amount` (integer)
    バリューポイントの量。

  - `items.value_point.is_clan` (boolean)
    バリューポイントがクランリワードチェーンで使用されるかどうか。

  - `items.steps` (array)

  - `items.steps.step_id` (integer)
    ステップID。
    Example: 10

  - `items.steps.name` (string)
    ステップ名。
    Example: "Level 1"

  - `items.steps.is_claimed` (boolean)
    ステップ報酬が請求されるかどうか。

  - `items.steps.image_url` (string)
    画像URL。

  - `items.steps.price` (object)

  - `items.steps.price.amount` (integer)
    ユーザーがそのステップに対して請求したバリューポイントの数。
    Example: 100

  - `items.steps.reward` (array)

  - `items.steps.reward.sku` (string)
    一意のアイテムID。SKUには、小文字と大文字のラテン英数字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。

  - `items.steps.reward.name` (string)
    アイテム名。
    Example: "Super box"

  - `items.steps.reward.type` (string)
    アイテムタイプ。
    Example: "bundle"

  - `items.steps.reward.description` (string)
    アイテムの説明。
    Example: "Super box with items"

  - `items.steps.reward.image_url` (string)
    画像URL。

  - `items.steps.reward.quantity` (integer)
    アイテム数量。
    Example: 2

  - `items.recurrent_schedule` (object,null)
    報酬チェーンの定期リセット期間。

  - `items.recurrent_schedule.interval_type` (any)

  - `items.recurrent_schedule.reset_next_date` (integer)
    計算された報酬チェーンが次回にリセットされる日時Unixタイムスタンプ。例えば、報酬チェーンは2024年3月1日01:00（クアラルンプール時間 GMT+8）から毎月リセットされます。報酬チェーンが次回にリセットされる日時：2024年4月1日01:00（クアラルンプール時間 GMT+8）。これは、2024年3月31日17:00 GMT+0またはUnixタイムスタンプのフォーマットで1711904400000に相当します。 例：1711904400000

  - `items.popup_header` (object,null)
    クラン報酬チェーンツールチップポップアップウィンドウのヘッダーのローカライズ付きオブジェクト。 小文字の2文字[言語コード](https://developers.xsolla.com/ja/doc/pay-station/features/localization/)。

  - `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)
    クラン報酬チェーンツールチップポップアップウィンドウに関する説明のローカライズ付きオブジェクト。 小文字の2文字[言語コード](https://developers.xsolla.com/ja/doc/pay-station/features/localization/)。

  - `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)
    クラン報酬チェーンのツールチップポップアップウィンドウの画像。


