开发文档 - 1234ID登录 - 专业账号登录聚合平台

1234ID登录聚合介绍

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

接口协议规则

传输方式：HTTP/HTTPS

数据格式：JSON

字符编码：UTF-8

登录聚合流程

Step1：获取跳转登录地址
请求URL：

https://www.1234id.com/connect.php?act=login&appid={你的appid}&appkey={你的appkey}&type={登录方式}&redirect_uri={返回地址}

其中登录方式对应值：

对应值	登录方式名称
qq	腾讯 QQ
wx	微信 Weixin
alipay	支付宝 Alipay
sina	微博 Weibo
baidu	百度 Baidu
douyin	抖音 Douyin
huawei	华为 Huawei
xiaomi	小米 Xiaomi
google	谷歌 Google
microsoft	微软 Microsoft
facebook	脸书 Facebook
twitter	推特 Twitter
dingtalk	钉钉 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： https://www.1234id.com/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": "XX市",
  "gender": "男",
  "ip": "127.0.0.1"
}

返回参数说明：

参数名	参数类型	参数说明	参数示例
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	用户所在地	XX市（仅限支付宝/微信返回）
ip	string	用户登录IP	127.0.0.1

获取用户信息接口

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

请求URL： https://www.1234id.com/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": "XX市",
  "gender": "男",
  "ip": "127.0.0.1"
}

返回参数说明：

参数名	参数类型	参数说明	参数示例
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	用户所在地	XX市（仅限支付宝/微信返回）
ip	string	用户登录IP	127.0.0.1

SDK下载

SDK版本：V1.0

更新时间：2022年5月24日

下载地址：SDK.zip

1234ID登录聚合开发文档