接入文档 - 众耀聚合登录

接口概述

聚合登录API接入说明

接口地址：
https://login.yiyingyong.com/connect.php

请求方式：GET / POST

返回格式：JSON

接入流程

注册账号并创建应用，获取 appid 和 appkey
调用登录接口获取授权URL，跳转用户授权
用户授权后回调到您的网站，携带 code 参数
调用回调接口，使用 code 换取用户信息

快速开始

5分钟完成接入

PHP 示例代码

login.php - 发起登录

<?php
$apiurl = 'https://login.yiyingyong.com/connect.php';
$appid  = '您的APPID';
$appkey = '您的APPKEY';
$type   = 'qq';
$redirect_uri = 'https://您的网站/callback.php';

$params = ['act' => 'login', 'appid' => $appid, 'appkey' => $appkey, 'type' => $type, 'redirect_uri' => $redirect_uri];
$result = json_decode(file_get_contents($apiurl . '?' . http_build_query($params)), true);

if ($result['code'] == 0) {
    header('Location: ' . $result['url']);
    exit;
}

callback.php - 处理回调

<?php
$code = $_GET['code'] ?? '';
$params = ['act' => 'callback', 'appid' => $appid, 'appkey' => $appkey, 'code' => $code];
$result = json_decode(file_get_contents($apiurl . '?' . http_build_query($params)), true);

if ($result['code'] == 0) {
    $social_uid = $result['social_uid']; // 用户唯一标识
    $nickname   = $result['nickname'];   // 昵称
    $faceimg    = $result['faceimg'];    // 头像
    $gender     = $result['gender'];     // 性别
}

登录接口

act=login

请求参数

参数名	必填	类型	说明
`act`	是	string	接口动作，固定值 `login`
`appid`	是	string	应用ID，在"我的应用"中获取，如：`f99abb60a4f4439d`
`appkey`	是	string	应用密钥，在"我的应用"中获取，请妥善保管不要泄露
`type`	是	string	登录平台类型，可选值：`qq`、`wx`、`alipay`、`sina`、`baidu`、`github`、`gitee`、`google`、`dingtalk`、`feishu` 等
`redirect_uri`	是	string	授权成功后的回调地址，必须与应用配置的授权域名匹配，需进行URL编码。示例：`https://example.com/callback.php`
`state`	否	string	自定义状态参数，用于防止CSRF攻击或传递业务数据，回调时会原样返回。建议传入随机字符串并在回调时验证

返回参数

参数名	类型	说明
`code`	int	状态码，`0`=成功，其他值表示失败
`msg`	string	返回信息，成功时为 `success`，失败时为错误描述
`type`	string	登录类型，与请求参数一致
`url`	string	第三方授权页面地址，需要将用户重定向（302跳转）到此地址进行授权

请求示例

https://login.yiyingyong.com/connect.php?act=login&appid=您的APPID&appkey=您的APPKEY&type=qq&redirect_uri=https://您的网站/callback.php&state=随机字符串

成功返回示例

{
    "code": 0,
    "msg": "success",
    "type": "qq",
    "url": "https://graph.qq.com/oauth2.0/authorize?response_type=code&client_id=xxx&redirect_uri=xxx&state=xxx"
}

失败返回示例

{
    "code": -1,
    "msg": "应用不存在或已禁用",
    "errcode": 102
}

回调接口

act=callback

说明：用户在第三方平台授权成功后，会携带 code 参数跳转到您设置的回调地址。您需要在回调页面调用此接口，用 code 换取用户信息。

请求参数

参数名	必填	类型	说明
`act`	是	string	接口动作，固定值 `callback`
`appid`	是	string	应用ID，与登录接口使用的一致
`appkey`	是	string	应用密钥，与登录接口使用的一致
`code`	是	string	授权码，从回调URL的 `code` 参数获取。注意：每个code只能使用一次，有效期约5分钟

返回参数

参数名	类型	说明
`code`	int	状态码：`0`=成功，`2`=等待用户授权中（轮询场景），其他=失败
`msg`	string	返回信息
`type`	string	登录平台类型，如 `qq`、`wx` 等
`social_uid`	string	用户在该平台的唯一标识，可用于关联本地用户账号。同一用户在同一平台的 social_uid 始终相同
`access_token`	string	访问令牌，部分平台可用于调用其他API
`nickname`	string	用户昵称/用户名
`faceimg`	string	用户头像URL地址
`gender`	int	用户性别：`0`=未知，`1`=男，`2`=女
`location`	string	用户所在地区，如"广东深圳"（部分平台可能为空）
`ip`	string	用户授权时的IP地址

请求示例

https://login.yiyingyong.com/connect.php?act=callback&appid=您的APPID&appkey=您的APPKEY&code=从回调获取的code

成功返回示例

{
    "code": 0,
    "msg": "success",
    "type": "qq",
    "social_uid": "ABCD1234567890",
    "access_token": "E8F7D6C5B4A3...",
    "nickname": "用户昵称",
    "faceimg": "https://thirdqq.qlogo.cn/g?b=oidb&k=xxx",
    "gender": 1,
    "location": "广东 深圳",
    "ip": "113.89.xxx.xxx"
}

重要提示：

social_uid 是用户的唯一标识，建议存储到数据库用于用户关联
每个 code 只能使用一次，重复使用会返回错误
用户头像URL可能会过期，建议下载保存到自己的服务器

查询接口

act=query

说明：根据 social_uid 查询已授权用户的缓存信息。适用于需要再次获取用户信息但不想让用户重新授权的场景。

请求参数

参数名	必填	类型	说明
`act`	是	string	接口动作，固定值 `query`
`appid`	是	string	应用ID
`appkey`	是	string	应用密钥
`type`	是	string	登录平台类型，如 `qq`、`wx` 等
`social_uid`	是	string	用户唯一标识，从回调接口获取

返回参数

参数名	类型	说明
`code`	int	状态码，`0`=成功
`msg`	string	返回信息
`type`	string	登录平台类型
`social_uid`	string	用户唯一标识
`access_token`	string	访问令牌（可能已过期）
`nickname`	string	用户昵称
`faceimg`	string	用户头像URL
`gender`	int	用户性别：`0`=未知，`1`=男，`2`=女
`location`	string	用户所在地区
`ip`	string	用户最后授权时的IP地址

请求示例

https://login.yiyingyong.com/connect.php?act=query&appid=您的APPID&appkey=您的APPKEY&type=qq&social_uid=用户的social_uid

成功返回示例

{
    "code": 0,
    "msg": "success",
    "type": "qq",
    "social_uid": "ABCD1234567890",
    "access_token": "E8F7D6C5B4A3...",
    "nickname": "用户昵称",
    "faceimg": "https://thirdqq.qlogo.cn/g?b=oidb&k=xxx",
    "gender": 1,
    "location": "广东 深圳",
    "ip": "113.89.xxx.xxx"
}

支持平台

type 参数可选值

QQ登录

type=qq

微信登录

type=wx

支付宝

type=alipay

微博登录

type=sina

百度登录

type=baidu

抖音登录

type=douyin

华为登录

type=huawei

谷歌登录

type=google

微软登录

type=microsoft

企业微信

type=wework

钉钉登录

type=dingtalk

飞书登录

type=feishu

Gitee

type=gitee

GitHub

type=github

小米登录

type=xiaomi

哔哩哔哩

type=bilibili

错误码说明

接口返回的错误码含义

code	errcode	说明	解决方案
`0`	-	请求成功	-
`2`	-	等待用户授权中	继续轮询等待，或提示用户完成授权
`-1`	101	参数缺失或无效	检查必填参数是否完整，参数值是否正确
`-1`	102	应用不存在或已禁用	检查 appid 是否正确，应用是否已被禁用
`-1`	103	appkey错误或回调域名未授权	检查 appkey 是否正确，回调地址域名是否与应用配置的授权域名匹配
`-1`	104	登录方式未开启或未配置	检查该登录平台是否已在应用中启用，平台是否已配置
`-1`	105	授权码无效或已过期	code 只能使用一次且有效期约5分钟，请重新发起授权
`-1`	106	用户不存在	查询接口使用的 social_uid 不存在
`-1`	201	调用次数已达上限	当日调用次数已用完，请升级套餐或等待次日重置
`-1`	301	第三方平台接口错误	第三方平台返回错误，请稍后重试或联系客服

SDK下载

快速集成SDK

PHP SDK

支持 PHP 7.0+

下载 SDK

JavaScript SDK

支持 Node.js / 浏览器

下载 SDK

Python SDK

支持 Python 3.6+

下载 SDK

准备好开始接入了吗？

免费注册，立即获取 APPID 和 APPKEY

免费注册