聚合登录定义

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

聚合登录流程

申请APPID

点击卡片联系客服申请APPID,长时间没有登录记录的appid将会被封禁。

Step 1.获取跳转登录地址

请求URL:
https://ucenter.splace.top/connect.php?appid={appid}&appkey={appkey}&type={登录方式}&act=login&redirect_uri={返回地址}
其中变量对应值及说明:

[appid]:平台申请的appid

[appkey]:平台申请的appkey

获取方式请参考怎么接入聚合登录。

[登录方式]

qq--QQ登录--可以用户头像,昵称,性别,uid信息;

wx--微信登录--可以用户头像,昵称,性别,uid信息。

微信获取用户信息需要用户同意才能获取

返回值示例及说明:

{
  "code": 0,//0为正常
  "msg": "succ",//错误时会返回信息
  "type": "qq",//传入的登录方式
  "url": "https://graph.qq.com/oauth2.0/XXXXXXXXXX",//跳转登录地址
  "state": "XXXXXXXXXX"//本次登录生成的唯一识别码(仅本次登录不变)
}

Step 2.引导用户跳转到url地址

Step 3.登录成功会自动跳转到指定的redirect_uri,并跟上Code

例如回调地址是:www.qq.com/my.php,则会跳转到: http://www.qq.com/my.php?type=qq&state=XXXXXXXXXXXXXX&code=XXXXXXXXXXXXX

其中,state的值不变。

Step4:通过Code获取用户信息

请求URL:
https://ucenter.splace.top/connect.php?appid={appid}&appkey={appkey}&type={登录方式}&act=callback&code={code}

返回值示例及说明:

{
  "code": 0,//0为正常
  "msg": "succ",//错误时会返回信息
  "type": "qq",//传入的登录方式
  "social_uid": "AAAAAAAAAAAAAAAA",//用户识别码
  "faceimg": "https://thirdqq.qlogo.cn/g?xxx",//需用户授权才能返回
  "nickname": "杨柳清风",//需用户授权才能返回
  "location": "XXXXX市",//需用户授权才能返回
  "gender": "男"//需用户授权才能返回
}

其中,不会返回state值。

通过上述的四个流程即可获得用户识别码,该识别码唯一可用于身份验证及绑定。安全性请参考OAuth2.0身份鉴权机制。

聚合登录接入规范

最后修改:2021 年 06 月 04 日 06 : 01 PM
如果觉得我的文章对你有用,请随意赞赏