开发文档

全面的技术文档和 API 参考,助您快速接入聚合登录系统

QQ
微信
企业微信
Gitee

聚合登录介绍

聚合登录是一种现代化的用户认证解决方案,允许用户使用第三方平台已有账号快速完成应用的登录流程。

通过本站的聚合登录接口,您的应用可以获取用户在第三方平台(如 QQ、微信、微博、支付宝、百度等)的身份信息和授权数据,包括但不限于用户唯一标识、访问令牌、昵称、头像等关键信息。

技术特点
  • 完全符合 OAuth 2.0 身份鉴权标准
  • 统一封装多个平台的差异性接口
  • 支持多种数据返回格式
  • 提供完善的错误处理机制

接口协议规则

HTTP
传输方式

基于 HTTP/HTTPS 协议进行通信

JSON
数据格式

统一使用 JSON 格式进行数据交换

UTF-8
字符编码

统一使用 UTF-8 字符编码

聚合登录流程

四步完成登录流程
  1. 获取跳转登录地址
  2. 跳转到第三方登录页面
  3. 获取授权码 (Authorization Code)
  4. 使用授权码换取用户信息

Step 1: 获取跳转登录地址

请求 URL:

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

登录方式对应值:

对应值 登录方式名称 图标
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,..." // 仅微信和支付宝返回
}

Step 2-3: 用户授权与回调

用户将在第三方平台完成授权,成功后自动跳转到指定的 redirect_uri,并携带授权码。

Step 4: 获取用户信息

使用授权码请求用户信息接口:

https://connect.va.mba/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
msg string 返回信息 succ
social_uid string 用户唯一标识 AD3F5033279C8187CBCBB29235D5F827
access_token string 访问令牌 89DC9691E274D6B596FFCB8D43368234
faceimg string 用户头像 https://thirdqq.qlogo.cn/g?...
nickname string 用户昵称 大白
gender string 用户性别

获取用户信息接口

在用户登录后的任意时间,可以使用以下接口查询用户的详细信息:

https://connect.va.mba/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

提供多语言版本的 SDK,帮助您快速集成到现有项目中

PHP SDK

适用于 PHP 5.6+

Python SDK

适用于 Python 3.6+

Node.js SDK

适用于 Node.js 10+

下载 SDK 完整包 (v1.0)

文件大小: ~2.5MB | 包含所有语言版本