# 获取当前用户的奖励链

客户端端点。获取当前用户的奖励链。

注意：所有项目对于可以在响应中获得的商品数量均都限制。默认值和最大值是每个响应50项。要逐页获取更多数据，请使用limit和offset字段。

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

## Path parameters:

  - `project_id` (integer, required)
    项目ID。您可以在您的发布商帐户项目名称旁边找到。
    Example: 44056

## Query parameters:

  - `limit` (integer)
    页面上元素数量的限制。
    Example: 50

  - `offset` (integer)
    元素编号，从该元素开始生成列表（从0开始数）。

## Response 200 fields (application/json):

  - `has_more` (boolean)
    用作指示还有更多页面。
    Example: true

  - `items` (array)

  - `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.date_end` (string,null)
    奖励链促销活动的结束日期。可以是null。如果date_end为null，则奖励链无时间限制。
    Example: "2020-04-15T18:16:00+05:00"

  - `items.date_start` (string)
    奖励链的开始日期。
    Example: "2020-04-15T18:16:00+05:00"

  - `items.description` (string,null)
    奖励链描述。
    Example: "Major weekly quest"

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

  - `items.long_description` (string,null)
    奖励链详细描述。
    Example: "You can get a lot of additional items just by shopping during the week"

  - `items.name` (string)
    奖励链名称。
    Example: "Weekly quest"

  - `items.order` (integer)
    定义排列顺序。
    Example: 1

  - `items.popup_header` (object,null)
    包含公会奖励链提示弹窗本地化标题的对象。两个小写字母的[语言代码](https://developers.xsolla.com/zh/doc/pay-station/features/localization/)。

  - `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)
    公会奖励链提示弹出窗口的图片。
    Example: "https://image.example.com"

  - `items.popup_instruction` (object,null)
    包含公会奖励链提示弹窗本地化说明的对象。两个小写字母的[语言代码](https://developers.xsolla.com/zh/doc/pay-station/features/localization/)。

  - `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.reward_chain_id` (integer)
    奖励链ID。
    Example: 9

  - `items.steps` (array)

  - `items.steps.is_claimed` (boolean)
    该步骤奖励是否已领取。

  - `items.steps.name` (string)
    步骤名称。
    Example: "Level 1"

  - `items.steps.price` (object)

  - `items.steps.price.amount` (integer)
    用户在该步骤中领取的奖励积分数。
    Example: 100

  - `items.steps.reward` (array)

  - `items.steps.reward.description` (string)
    商品描述。
    Example: "Super box with items"

  - `items.steps.reward.name` (string)
    商品名称。
    Example: "Super box"

  - `items.steps.reward.quantity` (integer)
    商品数量。
    Example: 2

  - `items.steps.reward.sku` (string)
    唯一商品ID。 SKU只能包含大小写英文字母和数字字符、句点、破折号和下划线。
    Example: "booster_mega_1"

  - `items.steps.reward.type` (string)
    商品类型。
    Example: "bundle"

  - `items.steps.step_id` (integer)
    步骤ID。
    Example: 10

  - `items.top_contributors` (array)

  - `items.top_contributors.contributed_amount` (integer)
    用户获得的奖励积分数。
    Example: 100

  - `items.top_contributors.name` (string)
    在授权过程中向艾克索拉发送的用户ID。用户ID用于将用户与您的艾克索拉登录管理器项目相关联，并显示为昵称。如果使用按[用户ID](https://developers.xsolla.com/zh/solutions/web-shop/create-web-shop/set-up-authentication/?tabs=100-UserIDAuth&link=100-UserIDAuth)授权，建议在[Webhook响应](https://developers.xsolla.com/zh/webhooks/operation/user-validation-in-webshop/)中传入name参数。该参数包含将用作昵称的用户名。
    Example: "Rocket"

  - `items.value_point` (object)

  - `items.value_point.amount` (integer)
    奖励积分的数量。

  - `items.value_point.description` (string,null)
    奖励积分描述。

  - `items.value_point.is_clan` (boolean)
    该奖励积分是否用于公会奖励链。
    Example: true

  - `items.value_point.long_description` (string,null)
    奖励积分详细描述。

  - `items.value_point.name` (string)
    奖励积分名称。

  - `items.value_point.sku` (string)
    唯一奖励积分ID。

  - `total_items_count` (integer)
    系统中奖励链的总数。
    Example: 10