聚合登录介绍
聚合登录，就是利用用户在第三方平台上已有的账号来快速完成自己应用的登录流程。这里的第三方平台，是指 QQ、微信、微博、百度 等平台。
通过本站的聚合登录接口，你的网站可以登录获取相应的用户信息和授权信息，例如uid、token、 用户昵称、头像等。本站的聚合登录完全符合 OAuth2.0 身份鉴权机制。
接口协议规则
🔒
传输方式
HTTP / HTTPS
📦
数据格式
JSON
🔤
字符编码
UTF-8
聚合登录流程
1
获取跳转登录地址
请求 URL：
url
https://login.blogcloud.cn/connect.php?act=login&appid={你的appid}&appkey={你的appkey}&type={登录方式}&redirect_uri={返回地址}支持的登录方式：
QQ
qq微信
wx支付宝
alipay微博
sina百度
baidu华为
huawei小米
xiaomi抖音
douyin钉钉
dingtalk返回格式：
json
{
"code": 0,
"msg": "succ",
"type": "qq",
"url": "https://graph.qq.com/oauth2.0/XXXXXXXXXX"
}| 参数名 | 类型 | 说明 | 示例 |
|---|---|---|---|
code | int | 返回状态码，0为成功，其它值为失败 | - |
msg | string | 返回信息，返回错误时的说明 | - |
type | string | 登录方式 | |
url | string | 登录跳转地址 | - |
qrcode | string | 登录扫码地址（仅微信和支付宝返回） | - |
2
跳转到登录地址
登录地址为上一步返回的 url 的值。 将用户重定向到该地址进行授权登录。
3
登录成功回调
登录成功会自动跳转到指定的 redirect_uri，并跟上 Authorization Code
回调示例：
url
http://www.qq.com/my.php?type=qq&code=520DD95263C1CFEA0870FBB66E******4
通过 Authorization Code 获取用户信息
请求 URL：
url
https://login.blogcloud.cn/connect.php?act=callback&appid={appid}&appkey={appkey}&type={登录方式}&code={code}返回格式：
json
{
"code": 0,
"msg": "succ",
"type": "qq",
"access_token": "89DC9691E274D6B596FFCB8D43368234",
"social_uid": "AD3F5033279C8187CBCBB29235D5F827",
"faceimg": "https://thirdqq.qlogo.cn/g?b=oidb&k=...",
"nickname": "大白",
"location": "XXXXX市",
"gender": "男",
"ip": "1.12.3.40"
}| 参数名 | 类型 | 说明 | 示例 |
|---|---|---|---|
code | int | 返回状态码，0为成功，2为未完成登录，其它值为失败 | - |
msg | string | 返回信息 | - |
type | string | 登录方式 | |
social_uid | string | 第三方登录UID | - |
access_token | string | 第三方登录token | - |
faceimg | string | 用户头像 | - |
nickname | string | 用户昵称 | - |
gender | string | 用户性别 | - |
location | string | 用户所在地（仅支付宝/微信返回） | - |
ip | string | 用户登录IP | - |
获取用户信息接口
在用户登录后的任意时间，可以请求以下接口再次查询用户的详细信息。social_uid就是用户的第三方登录UID，用于识别用户的唯一字段。
请求 URL：
url
https://login.blogcloud.cn/connect.php?act=query&appid={appid}&appkey={appkey}&type={登录方式}&social_uid={social_uid}返回格式：
json
{
"code": 0,
"msg": "succ",
"type": "qq",
"social_uid": "AD3F5033279C8187CBCBB29235D5F827",
"access_token": "89DC9691E274D6B596FFCB8D43368234",
"nickname": "大白",
"faceimg": "https://thirdqq.qlogo.cn/g?b=oidb&k=...",
"location": "XXXXX市",
"gender": "男",
"ip": "1.12.3.40"
}| 参数名 | 类型 | 说明 | 示例 |
|---|---|---|---|
code | int | 返回状态码，0为成功，其它值为失败 | - |
msg | string | 返回信息 | - |
type | string | 登录方式 | |
social_uid | string | 第三方登录UID | - |
access_token | string | 第三方登录token | - |
faceimg | string | 用户头像 | - |
nickname | string | 用户昵称 | - |
gender | string | 用户性别 | - |
location | string | 用户所在地（仅支付宝/微信返回） | - |
ip | string | 用户登录IP | - |
SDK 下载
最新版本 v1.0
官方 SDK
提供 PHP 等多种语言的 SDK，包含完整的示例代码和详细注释，帮助您快速集成
快速开始
- 1前往 用户中心 注册账号并创建应用，获取 AppID 和 AppKey
- 2下载 SDK 并解压到您的项目目录
- 3参照示例代码配置 AppID 和 AppKey
- 4在您的登录页面调用 SDK 方法即可完成接入
准备好开始了吗？
几分钟即可为您的网站添加社会化登录功能