获取当前用户的奖励链

Xsolla Developers

或

前往发布商帐户

获取当前用户的奖励链Client-side

get/v2/project/{project_id}/user/reward_chain

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

注意：

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

SecurityXsollaLoginUserJWT

Request

path Parameters

project_id

required

integer

项目编号。您可以在您的发布商帐户项目名称旁边。

Example: 44056

query Parameters

limit	integer Limit for the number of elements on the page. Example: limit=50
offset	integer 元素编号，从该元素开始生成列表（从0开始数）。 Example: offset=0

Responses

200

成功获取用户的奖励链。

Request samples

curl -i -X GET \
  'https://store.xsolla.com/api/v2/project/{project_id}/user/reward_chain?limit=50&offset=0' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Response samples

application/json

{"has_more": false,
"items": [{"clan_type": null,
"date_end": "2023-04-25T18:16:00+05:00",
"date_start": "2023-04-15T18:16:00+05:00",
"description": "Big weekly quest",
"image_url": "https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png",
"long_description": "You can get a lot of additional items just by shopping during the week",
"name": "Weekly quest",
"order": 1,
"popup_header": null,
"popup_image_url": null,
"popup_instruction": null,
"recurrent_schedule": {"interval_type": "weekly",
"reset_next_date": 1746057600
},
"reward_chain_id": 10,
"steps": [{"image_url": "https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg",
"is_claimed": true,
"name": "Level 1",
"price": {"amount": 100
},
"reward": [{"description": "Super box with items",
"image_url": "https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg",
"name": "Super box",
"quantity": 1,
"sku": "com.xsolla.box_1",
"type": "bundle"
},
{"description": "Mega box with items",
"image_url": "https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg",
"name": "Mega box",
"quantity": 1,
"sku": "com.xsolla.box_2",
"type": "bundle"
}
],
"step_id": 1
},
{"image_url": "https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg",
"is_claimed": false,
"name": "Level 2",
"price": {"amount": 200
},
"reward": [{"description": "Super box with items",
"image_url": "https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg",
"name": "Super box",
"quantity": 2,
"sku": "com.xsolla.box_1",
"type": "bundle"
},
{"description": "Mega box with items",
"image_url": "https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg",
"name": "Mega box",
"quantity": 2,
"sku": "com.xsolla.box_2",
"type": "bundle"
}
],
"step_id": 2
}
],
"top_contributors": null,
"value_point": {"amount": 130,
"description": null,
"image_url": "https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg",
"long_description": null,
"name": "Value point",
"sku": "com.xsolla.value_point_1"
}
},
{"clan_type": "guild",
"date_end": "2023-10-15T18:16:00+05:00",
"date_start": "2023-04-15T18:16:00+05:00",
"description": "Major weekly clan quest.",
"image_url": "https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png",
"long_description": "You and your clan members can get additional items for shopping during a certain month.",
"name": "Weekly clan quest",
"order": 2,
"popup_header": "How to unlock rewards",
"popup_image_url": "https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png",
"popup_instruction": "You should be a clan member to get clan rewards. You join a clan when a clan member invited you to the clan, and you accepted the invite. You can create your own clan.",
"recurrent_schedule": {"interval_type": "monthly",
"reset_next_date": 1746057600
},
"reward_chain_id": 12,
"steps": [{"image_url": "https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg",
"is_claimed": true,
"name": "Level 1",
"price": {"amount": 100
},
"reward": [{"description": "Super box with items",
"image_url": "https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg",
"name": "Super box",
"quantity": 1,
"sku": "com.xsolla.box_1",
"type": "bundle"
},
{"description": "Mega box with items",
"image_url": "https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg",
"name": "Mega box",
"quantity": 1,
"sku": "com.xsolla.box_2",
"type": "bundle"
}
],
"step_id": 1
},
{"image_url": "https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg",
"is_claimed": false,
"name": "Level 2",
"price": {"amount": 200
},
"reward": [{"description": "Super box with items",
"image_url": "https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg",
"name": "Super box",
"quantity": 2,
"sku": "com.xsolla.box_1",
"type": "bundle"
},
{"description": "Mega box with items",
"image_url": "https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg",
"name": "Mega box",
"quantity": 2,
"sku": "com.xsolla.box_2",
"type": "bundle"
}
],
"step_id": 2
}
],
"top_contributors": [{"contributed_amount": 100,
"name": "Rabbit"
},
{"contributed_amount": 80,
"name": "Rocket"
},
{"contributed_amount": 40,
"name": "Rain"
}
],
"value_point": {"amount": 80,
"description": "Value points for clan reward system.",
"image_url": "https://cdn.xsolla.net/img/misc/images/5c3b8b45c5be5fe7803e59fbc8041be4.png",
"long_description": "Value points given to clans to get new rewards in a reward chain.",
"name": "Clan Reward VP 1",
"sku": "com.xsolla.clan_value_point_1"
}
}
],
"total_items_count": 1
}

获取当前用户的奖励链Client-side

path Parameters

query Parameters

We respect your privacy