SDK开发文档

系统介绍

绝爱拾光聚合登录系统是一个专业的第三方社会化登录解决方案,支持QQ、微信等多种登录方式。通过本系统,您的网站可以快速集成第三方登录功能,简化用户注册流程,提升用户体验。

系统特点:

  • 支持QQ、微信等多种登录方式
  • 完整的OAuth2.0协议支持
  • 简单易用的API接口
  • 完善的安全防护机制
  • 详细的登录记录统计
接口协议规则

传输方式: HTTP/HTTPS

数据格式: JSON

字符编码: UTF-8

请求方法: GET/POST

接口地址: https://login.jueai.chat/connect.php

聚合登录流程
Step1:获取跳转登录地址
请求URL:
https://login.jueai.chat/connect.php?act=login&appid={你的appid}&appkey={你的appkey}&type={登录方式}&redirect_uri={返回地址}
其中登录方式对应值:
对应值 登录方式名称
qq QQ登录
wechat 微信公众号登录
返回格式:
{
  "code": 0,
  "msg": "成功",
  "type": "qq",
  "url": "https://graph.qq.com/oauth2.0/XXXXXXXXXX"
}
返回参数说明:
参数名 参数类型 参数说明 参数示例
code int 返回状态码 0为成功,其它值为失败
msg string 返回信息 返回错误时的说明
type string 登录方式 qq/wechat
url string 登录跳转地址 https://graph.qq.com/oauth2.0/XXXXXXXXXX

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

Step3:登录成功会自动跳转到指定的redirect_uri
例如回调地址是:www.example.com/callback.php,则会跳转到:
http://www.example.com/callback.php?type=wechat&social_uid=oouzo62jCmu1YugZ5seUelYp9-Kw&nickname=微信用户&faceimg=https://thirdwx.qlogo.cn/...&gender=0&location=&access_token=wxmp_1763896757

参数说明:
参数名 参数说明
type 登录方式
social_uid 用户唯一标识
nickname 用户昵称
faceimg 用户头像URL
gender 用户性别(0:未知 1:男 2:女)
location 用户地区
access_token 访问令牌
获取用户信息接口
在用户登录后的任意时间,可以请求以下接口再次查询用户的详细信息。

请求URL: https://login.jueai.chat/connect.php?act=query&appid={appid}&appkey={appkey}&type={登录方式}&social_uid={social_uid}
social_uid就是用户的第三方登录UID,用于识别用户的唯一字段。

返回格式:
{
  "code": 0,
  "msg": "成功",
  "type": "wechat",
  "social_uid": "oouzo62jCmu1YugZ5seUelYp9-Kw",
  "nickname": "微信用户_Yp9-Kw",
  "faceimg": "https://thirdwx.qlogo.cn/mmopen/vi_32/POgEwh4mIHO4nibH0KlMECNjjGxQUq24ZEaGT4poC6icRiccVGKSyXwibcPq4BWmiaIGuG1icwxaQX6grC9VemZoJ8rg/132",
  "gender": 0,
  "location": "",
  "ip": "127.0.0.1",
  "login_type": "wechat"
}
返回参数说明:
参数名 参数类型 参数说明 参数示例
code int 返回状态码 0为成功,其它值为失败
msg string 返回信息 返回错误时的说明
type string 登录方式 qq/wechat
social_uid string 第三方登录UID oouzo62jCmu1YugZ5seUelYp9-Kw
nickname string 用户昵称 微信用户_Yp9-Kw
faceimg string 用户头像 https://thirdwx.qlogo.cn/...
gender int 用户性别 0:未知 1:男 2:女
location string 用户所在地
ip string 用户登录IP 127.0.0.1
login_type string 登录方式 wechat
Demo下载

以下是完整的Demo示例代码,包含前端页面和后端接口调用示例。

  • PHP Demo示例

    文件结构:
    - index.php (前端页面)
    - connect.php (接口调用示例)
    - config.php (配置文件)
    - Oauth.class.php (SDK类文件)
    - Oauth.config.php (应用配置)

    使用说明:
    1. 修改Oauth.config.php中的配置信息
    2. 配置正确的回调地址
    3. 在管理后台设置应用ID和密钥

    demo_php.zip:
    立即下载

  • JavaScript示例
    // 跳转到登录页面
    function login(type) {
        const params = {
            act: 'login',
            appid: 'your_appid',
            appkey: 'your_appkey', 
            type: type,
            redirect_uri: encodeURIComponent('https://yoursite.com/callback')
        };
        
        const url = `https://login.jueai.chat/connect.php?${new URLSearchParams(params)}`;
        window.location.href = url;
    }
    
    // 处理回调
    const urlParams = new URLSearchParams(window.location.search);
    const social_uid = urlParams.get('social_uid');
    const nickname = urlParams.get('nickname');
    const faceimg = urlParams.get('faceimg');
    // ... 其他参数
                  

  • 错误代码说明
    错误代码 说明
    -1 系统错误或无效操作
    -2 参数不完整
    -3 应用验证失败
    -4 域名未授权
    0 成功

插件下载

以下是各种网站程序集成绝爱拾光聚合登录接口的插件下载,会不断更新,下载前请核对插件名是否正确,如网盘/下载链接失效反馈有奖!如以下没有你所使用的程序插件可到淘宝/找人写一下规则。

  • Emlog博客插件
  • Typecho博客插件
SDK下载

SDK版本:1.0

普通下载备用下载