自助测试

Hub 提供了测试模式，允许合作方在活动正式上线前进行完整的接口联调和业务验证。

测试模式

活动的生命周期分为三个状态：

状态	值	说明
测试中	TESTING	仅白名单用户可以领取奖励。受活动时间窗口限制。
进行中	LIVE	所有用户均可正常使用。受活动时间窗口限制。
已结束	ENDED	活动不再接受新的奖励发放。

当活动处于 测试中 TESTING 状态时：

• 只有被加入白名单的用户才能成功领取奖励。绑定流程与活动无关，不受白名单限制。
• 活动的开始时间和结束时间限制与正式发布时一致，测试需在活动时间窗口内进行。
• 非白名单用户发放奖励时，接口返回 event_in_testing 错误。

白名单机制

测试白名单由世游运营在管理后台配置，以世游通行证的用户 ID 为维度。

合作方需要将参与测试的人员的世游通行证账号提供给世游运营对接人，由其添加至白名单。

信息

白名单仅在活动处于 TESTING 状态时生效。活动切换为 LIVE 状态后，所有用户均可正常使用，白名单不再起作用。

测试流程

1. 世游运营在管理后台创建活动，状态设为 测试中。
2. 世游运营将参与测试的人员添加至白名单。
3. 世游运营将 event_id 和 reward_bundle_id 提供给合作方。
4. 合作方使用白名单用户完成以下测试：
   • 调用 POST /v1/request-bind 获取绑定链接，完成绑定流程。
   • 调用 GET /v1/query-binding 查询绑定状态和角色信息。
   • 调用 POST /v1/grant-reward 发放奖励，验证角色是否在游戏内收到邮件。
   • 调用 GET /v1/query-reward 查询奖励发放状态。
   • 测试各种异常场景：未绑定时发放奖励、重复发放、超过领取上限等。
5. 测试通过后，通知世游运营将活动状态切换为 进行中。