开发文档

聚合登录介绍

点我下载所有插件的下载地址(密码:8yd7)【蓝凑盘】

聚合登录,就是利用用户在第三方平台上已有的账号来快速完成自己应用的登录流程。这里的第三方平台,是指QQ、微信、微博、百度等平台。通过本站的聚合登录接口,你的网站可以登录获取相应的用户信息和授权信息,例如uid、token、用户昵称、头像等。本站的聚合登录完全符合OAuth2.0身份鉴权机制。

对接插件下载

以下是各种网站程序集成聚合CC登录接口的插件下载,此文章会不断更新。

魔方财务系统插件,使用方法: 上传到 /public/plugins/oauth 目录解压,然后在后台【系统】->【第三方登录】配置并开启即可。包含QQ、微信、支付宝、微博、百度5种登录方式。

点我下载魔方财务互联登录插件!


Discuz!X论坛插件,使用方法: 上传到 /source/plugin 目录解压,然后在后台插件列表就可以看到。包含QQ和微信2种登录方式,兼容DiscuzX 3.2~3.5版本,兼容utf-8、gbk、big5编码。

点我下载Discuz!X论坛互联登录插件!


SWAPIDC插件,使用方法: 上传到 /swap_mac/swap_plugins 目录解压,导入install.sql到数据库,然后在后台插件设置开启。包含QQ、微信、微博、支付宝4种登录方式。

点我下载SWAPIDC互联登录插件!


WHMCS插件,使用方法: 直接上传到根目录解压,在后台“插件模块”开启,并配置信息,然后在顶部“插件管理”->“聚合CC登录”,查看模板变量,自行修改模板文件。包含QQ、微信、微博、支付宝4种登录方式。只支持whmcs 8.x版本

点我下载WHMCS互联登录插件!


WordPress博客插件,使用方法: 上传到 /wp-content/plugins 目录解压,然后在后台插件列表启用即可。包含QQ、微信、支付宝、微博、百度、华为、钉钉、谷歌、微软、Facebook、Twitter登录方式。有些主题模板(如子比主题)已经默认集成了聚合CC登录,不需要安装该插件。

点我下载WordPress博客互联登录插件


Z-Blog博客插件,需要先安装LayCenter插件,然后上传到 /zb_users/LayCenter 目录解压,没有LayCenter文件夹就新建一个,然后在LayCenter后台应用列表启用即可。包含QQ、微信、支付宝、微博4种登录方式。

点我下载zblog_laycenter_plugin

Z-Blog博客插件2,需要先安装YtUser插件,然后上传到 /zb_users/plugin/YtUser 目录解压覆盖,在login.php里面修改接口地址,在后台填写QQ登录的appid和appkey

点我下载zblog_ytuser_plugin


Emlog博客插件,使用方法: 上传到 /content/plugins 目录解压,然后在后台插件列表开启,包含QQ和微信登录方式。

点我下载(适用于emlog5.3.1版本)

点我下载(适用于emlog pro版本))


Typecho博客插件,使用方法:上传到 /usr/plugins 目录解压,在后台插件列表开启即可,包含QQ、微信、支付宝、微博登录方式。插件开启后需要自行修改模板代码,加入登录按钮代码。

点我下载Typecho博客互联登录插件!

点我下载(修复包)Typecho 1.2.1版本有bug,登录方式无法保存,修复方法,下载Request.zip解压到/var/Typecho目录下。


苹果CMSV10插件,上传到根目录解压,在后台“整合登录配置”配置好密钥开启即可。包含QQ和微信登录方式。如果需要改登录接口地址,是在/extend/login/ThinkOauth.php里面。

点我下载苹果CMSV10互联登录插件!


HYBBS插件,上传到 /Plugin 目录解压,包含QQ、微信登录方式。

点我下载HYBBS互联登录插件!


XiunoBBS插件,上传到 /plugin 目录解压,包含QQ、微信、微博、支付宝4种登录方式。

点我下载XiunoBBS互联登录插件!


Eyoucms插件,上传到根目录解压覆盖,直接替换原有的QQ、微信、微博登录。

点我下载Eyoucms互联登录插件!


Flarum论坛插件,安装命令:composer require cccyun/flarum-clogin-oauth 安装好之后在后台开启,包含QQ、微信、微博登录方式。

点我下载Flarum论坛互联登录插件!


FastAdmin插件打开/vendor/karsonzhang/fastadmin-addons/src/addons/Service.php,把Service::valid($params);这一行注释掉。然后在后台插件管理,点击本地安装。

点我下载FastAdmin互联登录插件!


阿帕云插件需要申请阿帕云开发者权限,然后上传插件(如果提示插件标识已存在,可以把插件代码里面所有D8Login替换成新的插件标识),在后台我开发的插件里面安装,包含QQ、微信、微博、支付宝、百度登录方式。

点我下载阿帕云互联登录插件!


XunRuiCMS插件上传到根目录解压覆盖,包含QQ、微信、微博3种登录方式。分别在文件里面修改接口地址,在后台填写appid和appkey

点我下载XunRuiCMS互联登录插件!


魔方业务V10插件上传到 /public/plugins/oauth 解压,在后台 系统设置->三方登录 里面开启。包含QQ、微信、微博、支付宝、百度、钉钉等登录方式。

点我下载魔方业务V10插件互联登录插件!

接口协议规则

传输方式:HTTP

数据格式:JSON

字符编码:UTF-8

聚合登录流程
Step1:获取跳转登录地址
请求URL:
http://u.guur.cn/connect.php?act=login&appid={你的appid}&appkey={你的appkey}&type={登录方式}&redirect_uri={返回地址}
其中登录方式对应值:
对应值 登录方式名称
qq QQ
wx 微信
alipay 支付宝
sina 微博
baidu 百度
douyin 抖音
huawei 华为
google 谷歌
microsoft 微软
facebook Facebook
twitter Twitter
dingtalk 钉钉
gitee Gitee
github GitHub
返回格式:
{
  "code": 0,
  "msg": "succ",
  "type": "qq",
  "url": "https://graph.qq.com/oauth2.0/XXXXXXXXXX"
}
返回参数说明:
参数名 参数类型 参数说明 参数示例
code int 返回状态码 0为成功,其它值为失败
msg string 返回信息 返回错误时的说明
type string 登录方式 qq
url string 登录跳转地址 https://graph.qq.com/oauth2.0/XXXXXXXXXX
qrcode string 登录扫码地址 此地址仅微信和支付宝返回

Step2:跳转到登录地址
登录地址为上一步返回的url的值。

Step3:登录成功会自动跳转到指定的redirect_uri,并跟上Authorization Code
例如回调地址是:www.qq.com/my.php,则会跳转到:
http://www.qq.com/my.php?type=qq&code=520DD95263C1CFEA0870FBB66E******

Step4:通过Authorization Code获取用户信息
请求URL: http://u.guur.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为未完成登录,其它值为失败
msg string 返回信息 返回错误时的说明
type string 登录方式 qq
social_uid string 第三方登录UID AD3F5033279C8187CBCBB29235D5F827
access_token string 第三方登录token 89DC9691E274D6B596FFCB8D43368234
faceimg string 用户头像 https://thirdqq.qlogo.cn/g?......
nickname string 用户昵称 消失的彩虹海
gender string 用户性别
location string 用户所在地 XXXXX市(仅限支付宝/微信返回)
ip string 用户登录IP 1.12.3.40
获取用户信息接口
在用户登录后的任意时间,可以请求以下接口再次查询用户的详细信息。

请求URL: http://u.guur.cn/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"
}
返回参数说明:
参数名 参数类型 参数说明 参数示例
code int 返回状态码 0为成功,其它值为失败
msg string 返回信息 返回错误时的说明
type string 登录方式 qq
social_uid string 第三方登录UID AD3F5033279C8187CBCBB29235D5F827
access_token string 第三方登录token 89DC9691E274D6B596FFCB8D43368234
faceimg string 用户头像 https://thirdqq.qlogo.cn/g?......
nickname string 用户昵称 消失的彩虹海
gender string 用户性别
location string 用户所在地 XXXXX市(仅限支付宝/微信返回)
ip string 用户登录IP 1.12.3.40
SDK下载

SDK版本:1.0

点击下载