线路类型一[普通集群负载-IP接口]
线路类型二[普通集群负载-域名接口]
说明:域名接口会自动分发请求到普通集群服务器均衡负载,该域名TTL值为60秒,表示你的请求会每60秒实现自动轮换负载服务器,但也可能因你的网络服务商存在DNS缓存造成短时间内无法自动切换负载。如果某个负载服务器出现故障,也可能会造成个别地区存在一定时间的故障期。
线路类型三[VIP集群负载-VIP线路接口]
说明:VIP专属大带宽服务器集群组,每次请求自动均衡负载,自动故障切换,抗攻击,全球智能CDN加速。超高稳定性!最低24¥/月,登录后购买。注:VIP线路是指调用接口的线路更有保障以及每分钟拥有更高的调用频次等,并非收费接口包月使用。
请求示例
[GET]请求示例:(以下为公共KEY,共享每分钟调用频次,请登录后使用自己的KEY独享频次)
复制全部
复制参数
请求参数说明
注意:请求编码为UTF8,否则带中文请求可能失败。一般参数不能带+号,会被自动替换为空格。参数内容较大的必须用POST,不能GET。
提示:如发现接口有BUG,可加服务QQ群500700444,及时向我们反馈。
提示:请求参数里的开发者ID与KEY,登录后台菜单【个人资料】里查看。
| 名称 |
参数 |
必填 |
说明 |
| 开发者ID | id | 是 | 用户中心的数字ID,例:id=10000000 |
| 开发者KEY | key | 是 | 用户中心通讯秘钥,例:key=15he5h15ty854j5sr152hs2 |
| 查询编号 | cxid | 是 | 查询ID,通过调用聚合登录【1】-发起登录接口后得到的查询ID,例:cxid=1714456914213127557036 |
| 动态秘钥 | dkey | 否 | 开发者开启动态秘钥验证后需传此参数,主要针对直接在客户端调用接口的场景。请在官网后台菜单【个人资料】里配置。例:dkey=0cd2a494831736587c33f30d1e544371 |
| 用户IP | uip | 否 | 接口调用者IP,用于后台统计IP地域分布,ISP运营商,时段IP数统计等,如不传该参数则默认为接口请求端IP,该参数主要用于使用后端服务器/中间件请求接口的方式使用。例:uip=123.123.123.123。该参数彩钻/炫钻/焱钻会员专享。 |
返回参数说明
| 名称 |
参数 |
说明 |
| 状态码 | code | 200成功。400错误。 |
| 提示信息 | msg | 提示信息 |
| 登录方式 | type | 登录方式:1=QQ,2=微信,3=支付宝,4=新浪微博,5=百度,6=华为,7=小米,8=微软,9=钉钉,10=Gitee,11=GitHub,12=抖音,13=飞书。 |
| 发起时间 | addtime | 发起登录的时间 |
| 登录时间 | endtime | 完成登录的时间 |
| 三方ID | openid | 第三方登录账号的UID,请与自己的账号系统绑定,后期用户使用三方账号登录判断是否与该字段的信息一致即可。如果该字段不为空则表示登录成功,为空则表示还未登录或失败,可继续循环调用此接口。某些三方账号的ID较长,建议字段长度设置为255. |
| 用户头像 | faceimg | 三方用户头像,不一定返回。该信息为异步获取,如果返回了三方账号ID,可能存在一定延迟才会返回该字段内容。 |
| 用户昵称 | nickname | 三方用户昵称,不一定返回。该信息为异步获取,如果返回了三方账号ID,可能存在一定延迟才会返回该字段内容。 |
| 性别 | gender | 三方用户性别,不一定返回。该信息为异步获取,如果返回了三方账号ID,可能存在一定延迟才会返回该字段内容。 |
返回数据示例
示例:{"code":400,"msg":"通讯秘钥错误。"}
示例:
{
"code": 200,
"type": "1",
"addtime": "2026-01-04 05:07:44",
"endtime": "2026-01-04 05:07:44",
"openid": "1515254135",
"faceimg": "http://thirdqq.qlogo.cn/ek_qqapp/AQC0fQ6SIiaDHccmGzdBNZaHdUXkX7qE3uttXCtia6VxnTtenWAT4HwtibNKz1CibsIkA5Nq6ob3/40",
"nickname": "无有",
"gender": "男"
}
更新记录
2026-01-04 05:19:29 - 调整了某些字段名称。2024-04-30 14:44:55 - 新增接口。