# 获取当前用户的优惠链

获取当前用户的优惠链。
注意所有项目的单次响应中返回的商品数量都有上限。默认值和最大值为每次响应30个商品。如需更多数据，可通过limit与offset参数分页获取。

Endpoint: GET /v2/project/{project_id}/user/offer_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.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.id` (integer)
    优惠链ID。
    Example: 9

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

  - `items.next_step_number` (integer,null)
    下一步优惠链步骤编号，若优惠链已完成则为null。
    Example: 1

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

  - `items.recurrent_schedule` (object,null)
    优惠链的重置周期。

  - `items.recurrent_schedule.interval_type` (string)
    优惠链重置频率。
    Enum: "weekly", "monthly", "hourly"

  - `items.recurrent_schedule.reset_next_date` (integer)
    计算的下次优惠链重置的日期和时间，Unix时间戳格式。例如：月度优惠链重置从2024-03-01 01:00（吉隆坡时间，GMT+8）开始，下次重置为2024-04-01 01:00（吉隆坡时间，GMT+8），对应GMT+0为2024-03-31 17:00，Unix时间戳为1711904400000。示例：1711904400000

  - `items.steps` (array)

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

  - `items.steps.is_free` (boolean)
    是否为免费步骤：如为true，需通过领取免费优惠链步骤调用来领取。如为false，需通过为付费优惠链步骤创建订单调用来购买。

  - `items.steps.step_loyalty_rewards` (array,null)

  - `items.steps.step_loyalty_rewards.amount` (integer)
    忠诚积分数量。
    Example: 1

  - `items.steps.step_loyalty_rewards.description` (string)
    忠诚积分描述。
    Example: "First Loyalty Point Desc"

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

  - `items.steps.step_loyalty_rewards.name` (string)
    忠诚积分名称。
    Example: "First Loyalty Point"

  - `items.steps.step_loyalty_rewards.sku` (string)
    忠诚积分SKU。
    Example: "0c745ef0-4243-46e1-aa90-54dee07da622"

  - `items.steps.step_number` (integer)
    步骤编号。
    Example: 2

  - `items.steps.step_price` (object,null)

  - `items.steps.step_price.amount` (number, required)
    步骤的真实货币价格。
    Example: 99.99

  - `items.steps.step_price.currency` (string, required)
    商品价格货币。每[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217)。
    Example: "USD"

  - `items.steps.step_vp_rewards` (array,null)
    来自奖励系统的奖励积分数组，作为奖励发放。

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

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

  - `items.steps.step_vp_rewards.item_id` (integer)
    内部唯一物品ID。
    Example: 1

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

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

  - `total_items_count` (integer)
    可用优惠链总数。
    Example: 10