开发者文档中心

聚合登录介绍

聚合登录，就是利用用户在第三方平台上已有的账号来快速完成自己应用的登录流程。这里的第三方平台，是指QQ、微信、微博、百度等平台。通过本站的聚合登录接口，你的网站可以登录获取相应的用户信息和授权信息，例如uid、token、用户昵称、头像等。本站的聚合登录完全符合OAuth2.0身份鉴权机制。

接口协议规则

聚合登录流程

Step1：获取跳转登录地址

请求 URL 示例：

https://u.fxyo.cn/connect.php?act=login&appid={你的appid}&appkey={你的appkey}&type={登录方式}&redirect_uri={返回地址}

登录方式对应表：

对应值	登录方式名称
qq	QQ
wxopen	微信
wx	公众号
alipay	支付宝
sina	微博
baidu	百度
douyin	抖音
bilibili	哔哩哔哩
huawei	华为
xiaomi	小米
aliyun	阿里云
dingtalk	钉钉
discord	Discord
facebook	Facebook
gitee	Gitee
github	GitHub
google	谷歌
microsoft	微软
feishu	飞书
wework	企业微信
x	X
telegram	Telegram

Step2：跳转到授权页面

由后端解析上一步返回的 JSON 数据中的 url 字段，将用户重定向至该地址。

Step3：授权回跳

授权成功后，会跳转至指定的 redirect_uri，并携带 code 参数。

获取用户信息

请求示例：

https://u.fxyo.cn/connect.php?act=callback&appid={appid}&appkey={appkey}&type={登录方式}&code={code}

成功返回示例：

{
  "code": 0,
  "msg": "succ",
  "type": "qq",
  "access_token": "89DC9691E274D6B596FFCB8D43368234",
  "social_uid": "AD3F5033279C8187CBCBB29235D5F827",
  "faceimg": "https://thirdqq.qlogo.cn/g?b=oidb&k=...",
  "nickname": "大白"
}