开发文档

聚合快捷登录中转API介绍

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

接口协议规则

传输方式:HTTP

数据格式:JSON

字符编码:UTF-8

聚合快捷登录中转API流程
Step1:获取跳转登录地址
请求URL:
https://login.iyouhun.com/connect.php?appid={你的appid}&appkey={你的appkey}&type={登录方式}&act=login&redirect_uri={返回地址}
其中登录方式对应值:
对应值 说明
qq QQ快捷登录
wx 微信快捷登录(暂不支持)
sina 新浪微博快捷登录(暂不支持)
baidu 百度快捷登录(暂不支持)
alipay 支付宝快捷登录(暂不支持)
返回格式:
{
  "code": 0,
  "msg": "succ",
  "type": "qq",
  "url": "https://graph.qq.com/oauth2.0/XXXXXXXXXX"
}
返回参数说明:
参数名 参数类型 参数说明 参数示例
code int 返回状态码 1为成功,其它值为失败
msg string 返回信息 返回错误时的说明
type string 登录方式 qq
url string 登录跳转地址 https://graph.qq.com/oauth2.0/XXXXXXXXXX

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: https://login.iyouhun.com/connect.php?appid={appid}&appkey={appkey}&type={登录方式}&act=callback&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": "聚合快捷登录中转API",
  "location": "XXXXX市",
  "gender": "男"
}
返回参数说明:
参数名 参数类型 参数说明 参数示例
code int 返回状态码 1为成功,其它值为失败
msg string 返回信息 返回错误时的说明
type string 登录方式 qq
social_uid string 第三方登录UID AD3F5033279C8187CBCBB29235D5F827
access_token string 第三方登录token 89DC9691E274D6B596FFCB8D43368234
faceimg string 用户头像 https://thirdqq.qlogo.cn/g?......
nickname string 用户昵称 聚合快捷登录中转API
gender string 用户性别
location string 用户所在地 XXXXX市(仅限支付宝返回)
获取用户信息接口
在用户登录后的任意时间,可以请求以下接口再次查询用户的详细信息。

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

返回格式:
{
  "code": 0,
  "msg": "succ",
  "type": "qq",
  "social_uid": "AD3F5033279C8187CBCBB29235D5F827",
  "access_token": "89DC9691E274D6B596FFCB8D43368234",
  "nickname": "聚合快捷登录中转API",
  "faceimg": "https://thirdqq.qlogo.cn/g?b=oidb&k=ianyRGEnPZlMV2aQvvzg2uA&s=100&t=1599703185",
  "location": "XXXXX市",
  "gender": "男",
  "ip": "1.X.X.40"
}
返回参数说明:
参数名 参数类型 参数说明 参数示例
code int 返回状态码 1为成功,其它值为失败
msg string 返回信息 返回错误时的说明
type string 登录方式 qq
social_uid string 第三方登录UID AD3F5033279C8187CBCBB29235D5F827
access_token string 第三方登录token 89DC9691E274D6B596FFCB8D43368234
faceimg string 用户头像 https://thirdqq.qlogo.cn/g?......
nickname string 用户昵称 聚合快捷登录中转API
gender string 用户性别
location string 用户所在地 XXXXX市(仅限支付宝返回)
ip string 用户登录IP 1.X.X.40
API接口申请

API接口地址:https://login.iyouhun.com/

点击申请

SDK下载

SDK版本:1.0

点击下载