绑定流程
本文描述用户从合作方平台发起绑定到完成绑定的完整流程。
流程概览
详细步骤
1. 合作方发起绑定请求
合作方服务端调用 POST /v1/request-bind 接口，传入用户在合作方平台的标识和目标游戏。
2. 获取绑定链接
接口返回一个带有 Bind Token 的绑定页面 URL（bind_url）。
信息
Bind Token 的有效期以接口返回的 expires_in 为准。过期后需重新调用 request-bind 接口获取新的链接。
3. 引导用户跳转
合作方将用户引导至返回的 bind_url。用户在世游通行证页面完成以下操作：
- 登录世游通行证（如尚未登录）
- 选择要绑定的角色，具体有两种方式：
- 列表选择：若用户为官方渠道用户，系统自动展示其名下的角色列表，用户直接选择即可。
- OTP 验证：若用户为联运渠道用户（无法自动列出角色），需手动输入角色 ID，系统向该角色的游戏内邮箱发送一次性验证码，用户输入验证码完成验证。
4. 完成绑定
用户完成角色选择和确认后，系统执行绑定并将用户重定向至合作方提供的 redirect_url。
警告
世游侧不会在 redirect_url 上附加任何查询参数（如绑定结果）。合作方应当在用户回到页面后，主动调用 查询绑定 接口确认绑定结果。
提示
世游侧会原样使用合作方提供的 redirect_url 进行重定向。合作方可以在发起绑定请求时，在 redirect_url 上自行附加业务参数（例如自定义的流程标识），用于在用户回跳后识别对应的绑定流程。
5. 查询绑定结果
合作方服务端调用 GET /v1/query-binding 接口查询绑定结果。如果绑定成功，接口将返回完整的绑定信息和角色数据。
解绑
用户可通过世游通行证页面的「平台互联」页面自行解绑已绑定角色。
解绑后，合作方再次调用查询绑定接口将返回 binding_not_found 错误。如需重新绑定，需再次发起绑定流程。