开发者文档 - 永迪联聚合登录 - 社会化账号聚合登录系统

聚合登录介绍

Unified Login Introduction

聚合登录致力于解决网站繁琐的登录方式。利用用户在第三方平台上已有的账号（如 QQ、微信、微博、支付宝等）来快速完成身份认证。

通过标准化的 API 接口，开发者可以轻松获取用户的 uid、token 以及昵称、头像等公开信息。本站完全遵循 OAuth 2.0 协议，安全、稳定、高效。

接口协议规则

Protocol

传输方式 HTTP / HTTPS

数据格式 JSON

字符编码 UTF-8

聚合登录流程

1

获取跳转登录地址 GET

connect.php?act=login

Request URL Format

                                            https://u.gvxin.com/connect.php?act=login&appid={appid}&appkey={appkey}&type={type}&redirect_uri={url}

登录方式 (type)	说明
qq	ＱＱ
wx	微信
alipay	支付宝
sina	微博
baidu	百度
douyin	抖音
huawei	华为
xiaomi	小米
google	谷歌
microsoft	微软
dingtalk	钉钉
gitee	Gitee
github	GitHub

返回示例 (JSON)

{
  "code": 0,
  "msg": "succ",
  "type": "qq",
  "url": "https://graph.qq.com/oauth2.0/authorize?..."
}
                                        

跳转至认证页

前端获取到 Step 1 返回的 JSON 后，提取 url 字段，将用户浏览器重定向到该地址。

接收回调 Code

用户在第三方平台授权后，会携带 code 跳转回您设置的 redirect_uri。

http://www.your-site.com/callback.php?type=qq&code=520DD95263C1CFEA087...

2

获取用户信息 GET

connect.php?act=callback

Request

https://u.gvxin.com/connect.php?act=callback&appid={appid}&appkey={appkey}&type={type}&code={code}

Response (User Info) 200 OK

{
  "code": 0,
  "msg": "succ",
  "type": "qq",
  "access_token": "89DC9691E274D6B596FFCB8D43368234",
  "social_uid": "AD3F5033279C8187CBCBB29235D5F827",
  "faceimg": "https://thirdqq.qlogo.cn/g?b=oidb&...",
  "nickname": "测试用户",
  "location": "上海市",
  "gender": "男",
  "ip": "127.0.0.1"
}
                                        

查询用户信息 (Query)

在用户登录后的任意时间，可以通过唯一的 social_uid 再次从服务器拉取最新的用户资料。

API Interface

https://u.gvxin.com/connect.php?act=query&appid={appid}&appkey={appkey}&type={type}&social_uid={uid}

返回字段	类型	说明
social_uid	String	平台唯一用户标识 ID（OpenID）
nickname	String	用户昵称
faceimg	String	高清头像 URL 地址

Developer Tools

准备好开始了吗？

下载官方封装的 SDK 工具包，包含 PHP、Java、Node.js 等多种语言示例。内置签名算法与异常处理，让开发效率提升 90%。

v1.0.2 Stable ZIP Archive

立即下载 SDK

查看 GitHub 仓库