聚合登录Logo 聚合登录

开发文档

本文档提供尊狐云聚合登录系统的接口说明、调用流程与SDK使用指南，帮助开发者快速集成

聚合登录介绍

聚合登录，就是利用用户在第三方平台上已有的账号来快速完成自己应用的登录流程。这里的第三方平台，是指QQ、微信、微博、百度等平台。

通过本站的聚合登录接口，你的网站可以登录获取相应的用户信息和授权信息，例如uid、token、用户昵称、头像等。本站的聚合登录完全符合OAuth2.0身份鉴权机制，确保数据安全与授权合规。

接口协议规则

传输方式

HTTP

数据格式

JSON

字符编码

UTF-8

聚合登录流程

1

获取跳转登录地址

请求URL：

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

其中登录方式对应值：

对应值 登录方式名称
qq ＱＱ
wx 微信
alipay 支付宝
sina 微博
baidu 百度
douyin 抖音
huawei 华为
xiaomi 小米
google 谷歌
microsoft 微软
facebook Facebook
twitter Twitter
feishu 飞书
dingtalk 钉钉
gitee Gitee
github GitHub

返回格式：

{
  "code": 0,
  "msg": "succ",
  "type": "qq",
  "url": "https://graph.qq.com/oauth2.0/XXXXXXXXXX",
  "qrcode": "https://xxx.com/qrcode.png" // 仅微信/支付宝返回
}

返回参数说明：

参数名 参数类型 参数说明 参数示例
code int 返回状态码（0为成功） 0
msg string 返回信息 succ
type string 登录方式 qq
url string 登录跳转地址 https://graph.qq.com/oauth2.0/...
qrcode string 登录扫码地址（仅微信/支付宝） https://xxx.com/qrcode.png
2

跳转到登录地址

将用户浏览器重定向到 Step1 返回的 url 字段值，用户完成第三方平台登录授权。

3

登录成功回调

用户登录成功后，第三方平台会自动跳转到你指定的 redirect_uri，并携带 Authorization Code，示例：

http://www.qq.com/my.php?type=qq&code=520DD95263C1CFEA0870FBB66E******
4

通过Code获取用户信息

请求URL：

https://login.blogcloud.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=3WrWp3peBxlW4MFxDgDJEQ&s=100&t=1596856919",
  "nickname": "大白",
  "location": "XXXXX市",
  "gender": "男",
  "ip": "1.12.3.40"
}

返回参数说明：

参数名 参数类型 参数说明 参数示例
code int 状态码（0成功，2未完成登录） 0
social_uid string 第三方平台唯一标识 AD3F5033279C8187...
access_token string 第三方授权令牌 89DC9691E274D6B5...
faceimg string 用户头像URL https://thirdqq.qlogo.cn/...
location string 用户所在地（仅微信/支付宝） XXXXX市

获取用户信息接口

在用户登录后的任意时间，可通过以下接口查询用户最新信息（需使用登录时返回的 social_uid 作为用户唯一标识）。

请求URL：

https://login.blogcloud.cn/connect.php?act=query&appid={appid}&appkey={appkey}&type={登录方式}&social_uid={social_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"
}

返回参数说明与“聚合登录流程 Step4”一致，此处不再重复。

SDK下载

SDK 版本：v1.0

包含PHP、Java、Python三种语言的SDK，内置接口调用示例、错误处理与签名验证逻辑，帮助开发者快速集成。

立即下载