接口协议规则
传输方式:HTTP
数据格式:JSON
字符编码:UTF-8
登录流程
Step1:获取跳转登录地址
https://login.kw71.com/connect.php?act=login&appid={你的appid}&appkey={你的appkey}&type={登录方式}&redirect_uri={返回地址}
登录方式对应值:
对应值 | 登录方式名称 |
QQ | |
alipay | 支付宝 |
baidu | 百度 |
huawei | 华为 |
谷歌 | |
microsoft | 微软 |
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 | 登录方式 | |
url | string | 登录跳转地址 | http://qq.com/oauth2.0 |
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:// login.kw71.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”: “XXXXX市”,
“gender”: “男”,
“ip”: “1.12.3.40”
}
返回参数说明:
参数名 | 参数类型 | 参数说明 | 参数示例 |
code | int | 返回状态码 | 0成功,2未完成登录; 其它值为失败 |
msg | string | 返回信息 | 返回错误时的说明 |
type | string | 登录方式 | |
social_uid | string | 第三方登录UID | AD37CBCB9235D827 |
access_token | string | 第三方登录token | 89D6FFCB843368234 |
faceimg | string | 用户头像 | https:// qlogo.cn/g…… |
nickname | string | 用户昵称 | zeus |
gender | string | 用户性别 | 男 |
location | string | 用户所在地 | (仅限支付宝/微信返回) |
ip | string | 用户登录IP | 1.12.3.40 |
获取用户信息
在用户登录后的任意时间,可以请求以下接口再次查询用户的详细信息。
请求URL:
https://login.kw71.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”: “XXXXX市”,
“gender”: “男”,
“ip”: “1.12.3.40”
}
code | int | 返回状态码 | 0为成功,其它值为失败 |
msg | string | 返回信息 | 返回错误时的说明 |
type | string | 登录方式 | |
social_uid | string | 第三方登录UID | AD335D5F827…… |
access_token | string | 第三方登录token | 89DCFFC8234…… |
faceimg | string | 用户头像 | https://sdmi88.cn/? |
nickname | string | 用户昵称 | zeus |
gender | string | 用户性别 | 男 |
location | string | 用户所在地 | X市(仅限支付宝/微信返回) |
ip | string | 用户登录IP | 1.12.3.40 |
SDK下载
SDK版本:1.0
没有回复内容