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

传输方式：HTTP

数据格式：JSON

字符编码：UTF-8

Step1：获取跳转登录地址

请求URL：

https://u.navw.cn/connect.php?act=login&appid={appid}&appkey={appkey}&type={登录方式}&redirect_uri={返回地址}

登录方式对应值：

对应值	登录方式
qq	ＱＱ
wx	微信
alipay	支付宝
sina	微博
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/...
qrcode	string	扫码地址	仅微信/支付宝返回

Step2：跳转到登录地址

登录地址为上一步返回的url值。

Step3：登录成功回调

登录成功后自动跳转到redirect_uri，并附带code参数：

http://www.qq.com/my.php?type=qq&code=520DD95263C1CFEA0870FBB66E******

Step4：获取用户信息

请求URL：

https://u.navw.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/...",
  "nickname": "大白",
  "location": "XXXXX市",
  "gender": "男",
  "ip": "1.12.3.40"
}

参数名	类型	说明	示例
code	int	状态码	0成功，2未完成，其它失败
msg	string	返回信息	错误说明
type	string	登录方式	qq
social_uid	string	第三方UID	AD3F5033279C8187...
access_token	string	登录token	89DC9691E274D6B5...
faceimg	string	用户头像	https://...
nickname	string	用户昵称	大白
gender	string	用户性别	男
location	string	所在地	仅支付宝/微信返回
ip	string	登录IP	1.12.3.40

在用户登录后的任意时间，可以请求以下接口再次查询用户信息。

请求URL：

https://u.navw.cn/connect.php?act=query&appid={appid}&appkey={appkey}&type={登录方式}&social_uid={social_uid}

返回格式：

{
  "code": 0,
  "msg": "succ",
  "type": "qq",
  "social_uid": "AD3F5033279C8187CBCBB29235D5F827",
  "access_token": "89DC9691E274D6B596FFCB8D43368234",
  "nickname": "大白",
  "faceimg": "https://thirdqq.qlogo.cn/...",
  "location": "XXXXX市",
  "gender": "男",
  "ip": "1.12.3.40"
}

参数名	类型	说明	示例
code	int	状态码	0成功，其它失败
msg	string	返回信息	错误说明
type	string	登录方式	qq
social_uid	string	第三方UID	AD3F5033279C8187...
access_token	string	登录token	89DC9691E274D6B5...
faceimg	string	用户头像	https://...
nickname	string	用户昵称	大白
gender	string	用户性别	男
location	string	所在地	仅支付宝/微信返回
ip	string	登录IP	1.12.3.40

SDK版本：1.0

点击下载