获取绑定链接

POST /v1/request-bind

合作方调用此接口获取一个绑定链接，将用户引导至世游通行证页面完成账号绑定。

信息

关于完整的绑定流程，请参见 绑定流程。

Request

Property	Type	Required	Description
game_id	string	True	要绑定的游戏 ID。由世游侧分配。
partner_user_id	string	True	合作方平台的用户唯一标识。
partner_user_name	string	False	合作方平台的用户昵称，用于在绑定页面展示。
partner_user_avatar_url	string	False	合作方平台的用户头像 URL，用于在绑定页面展示。
redirect_url	string	False	绑定完成后的重定向地址。支持非 HTTP 协议（如 App Deep Link）。

示例：

{
  "game_id": "example_game",
  "partner_user_id": "user_12345",
  "partner_user_name": "用户昵称",
  "partner_user_avatar_url": "https://example.com/avatar/12345.jpg",
  "redirect_url": "https://www.example.com/bindresult"
}

Response

Property	Type	Description
bind_url	string	绑定页面的完整 URL，合作方需引导用户跳转至此地址。
expires_in	int	bind_url 的有效期（秒），默认 1800（30 分钟）。

示例：

{
  "bind_url": "https://account.seayoo.com/#/bind?token=aBcDeFgHiJkLmNoPqRsTuVwXyZ",
  "expires_in": 1800
}

信息

bind_url 过期后需要重新调用本接口获取新的链接。

Errors

Error	Description
invalid_request	请求参数缺失或格式错误。
invalid_signature	签名验证不通过。
partner_disabled	合作方已被禁用。
internal_error	服务端内部错误。