全面的技术文档和 API 参考,助您快速接入聚合登录系统
聚合登录是一种现代化的用户认证解决方案,允许用户使用第三方平台已有账号快速完成应用的登录流程。
通过本站的聚合登录接口,您的应用可以获取用户在第三方平台(如 QQ、微信、微博、支付宝、百度等)的身份信息和授权数据,包括但不限于用户唯一标识、访问令牌、昵称、头像等关键信息。
基于 HTTP/HTTPS 协议进行通信
统一使用 JSON 格式进行数据交换
统一使用 UTF-8 字符编码
请求 URL:
登录方式对应值:
| 对应值 | 登录方式名称 | 图标 |
|---|---|---|
qq |
QQ | |
wx |
微信 | |
wework |
企业微信 | |
gitee |
Gitee |
返回格式:
{
"code": 0,
"msg": "succ",
"type": "qq",
"url": "https://graph.qq.com/oauth2.0/XXXXXXXXXX",
"qrcode": "data:image/png;base64,..." // 仅微信和支付宝返回
}
用户将在第三方平台完成授权,成功后自动跳转到指定的 redirect_uri,并携带授权码。
使用授权码请求用户信息接口:
返回示例:
{
"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 |
msg |
string | 返回信息 | succ |
social_uid |
string | 用户唯一标识 | AD3F5033279C8187CBCBB29235D5F827 |
access_token |
string | 访问令牌 | 89DC9691E274D6B596FFCB8D43368234 |
faceimg |
string | 用户头像 | https://thirdqq.qlogo.cn/g?... |
nickname |
string | 用户昵称 | 大白 |
gender |
string | 用户性别 | 男 |
在用户登录后的任意时间,可以使用以下接口查询用户的详细信息:
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,帮助您快速集成到现有项目中
适用于 PHP 5.6+
适用于 Python 3.6+
适用于 Node.js 10+
文件大小: ~2.5MB | 包含所有语言版本