聚合登录是一种便捷的登录方式,它允许用户使用在第三方平台(如QQ、微信、抖音、微博、百度等)上已有的账号,迅速完成当前应用的登录过程。借助我们提供的聚合登录接口,您的网站能够轻松获取用户的相关信息和授权数据,包括用户ID、令牌、昵称及头像等。此外,我们的聚合登录服务严格遵循OAuth2.0身份验证标准,确保登录过程的安全可靠。
接口协议规则
- 传输方式:HTTP
- 数据格式:JSON
- 字符编码:UTF-8
聚合登录流程
Step1:获取跳转登录地址
请求URL:
https://uniqueker.top/connect.php?act=login&appid={你的appid}&appkey={你的appkey}&type={登录方式}&redirect_uri={返回地址}
其中登录方式对应值:
返回格式:
{
“code”: 0,
“msg”: “succ”,
“type”: “qq”,
“url”: “https://graph.qq.com/oauth2.0/XXXXXXXXXX”
}
返回参数说明:
Step2:跳转到登录地址
登录地址为上一步返回的url的值。
Step3:登录成功会自动跳转到指定的redirect_uri,并跟上Authorization Code
例如回调地址是:www.qq.com/my.php,则会跳转到:
http://www.qq.com/my.php?type=qq&code=520DD95263C1CFEA0870FBB66E******
Step4:通过Authorization Code获取用户信息
请求URL:
https://uniqueker.top/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=3WrWp3peBxlW4MFxDgDJEQ&s=100&t=1596856919”,
“nickname”: “大白”,
“location”: “XXXXX市”,
“gender”: “男”,
“ip”: “1.12.3.40”
}
返回参数说明:
获取用户信息接口
在用户登录后的任意时间,可以请求以下接口再次查询用户的详细信息。
请求URL:
https://uniqueker.top/connect.php?act=query&appid={appid}&appkey={appkey}&type={登录方式}&social_uid={social_uid}
social_uid就是用户的第三方登录UID,用于识别用户的唯一字段。
返回格式:
{
“code”: 0,
“msg”: “succ”,
“type”: “qq”,
“social_uid”: “AD3F5033279C8187CBCBB29235D5F827”,
“access_token”: “89DC9691E274D6B596FFCB8D43368234”,
“nickname”: “大白”,
“faceimg”: “https://thirdqq.qlogo.cn/g?b=oidb&k=ianyRGEnPZlMV2aQvvzg2uA&s=100&t=1599703185”,
“location”: “XXXXX市”,
“gender”: “男”,
“ip”: “1.12.3.40”
}
返回参数说明:
SDK下载
SDK版本:1.0