做用户资料补全、社交账号展示、头像回填或开发者工具箱时经常会遇到一个轻量需求输入一个 QQ 号返回基础资料和头像地址。自己处理这类数据时需要考虑号码校验、昵称编码、头像尺寸、QQ 空间链接等细节。qq接口把这些信息整理成了一个标准 GET API。开发时只需要传入 QQ 号就能拿到 QQ 昵称、QQ 邮箱、QQ 空间 URL以及 40、100、140、640 四种尺寸的头像直链。官方页面https://apizero.cn/marketplace/qq接口能做什么qq接口的核心能力很直接根据 QQ 号查询公开基础信息并返回适合前端展示的头像地址。它会返回QQ 号QQ 昵称QQ 邮箱QQ 空间链接多尺寸头像 URL是否查询到该 QQ这类结构很适合直接接到用户资料页、客服后台、账号查询工具、头像预览组件里。请求方式接口地址GET https://v1.apizero.cn/api/qq请求参数参数类型必填说明qqstring是5 到 11 位纯数字 QQ 号请求头Header说明AuthorizationAPI Key 鉴权头可按项目接入方式配置最简单的请求示例curlhttps://v1.apizero.cn/api/qq?qq88888888带鉴权头的请求示例curlhttps://v1.apizero.cn/api/qq?qq88888888\-HAuthorization: Bearer YOUR_API_KEY返回字段接口返回结构比较适合前端直接消费字段类型说明qqstring查询的 QQ 号namestringQQ 昵称mailstringQQ 邮箱地址qzonestringQQ 空间个人主页avatarsobject多尺寸头像对象avatars.s40string40×40 头像avatars.s100string100×100 头像avatars.s140string140×140 头像avatars.s640string640×640 高清头像is_foundboolean是否查询到该 QQ返回示例{code:0,msg:成功,data:{qq:88888888,name:,mail:88888888qq.com,qzone:https://user.qzone.qq.com/88888888,avatars:{s40:https://q1.qlogo.cn/g?bqqnk88888888s40,s100:https://q1.qlogo.cn/g?bqqnk88888888s100,s140:https://q1.qlogo.cn/g?bqqnk88888888s140,s640:https://q1.qlogo.cn/g?bqqnk88888888s640},is_found:true},request_id:mpl8a642714dcb60}如果页面上只需要头像一般优先使用data.avatars.s100如果是资料详情页或高清头像预览可以使用data.avatars.s640Python 调用示例下面是一个最小可用的 Python 示例importrequests urlhttps://v1.apizero.cn/api/qqparams{qq:88888888}headers{Authorization:Bearer YOUR_API_KEY}resprequests.get(url,paramsparams,headersheaders,timeout10)resultresp.json()dataresult[data]print(QQ:,data[qq])print(昵称:,data[name])print(邮箱:,data[mail])print(空间:,data[qzone])print(高清头像:,data[avatars][s640])如果要把接口接到后端服务里可以封装成一个函数importrequestsdefget_qq_profile(qq:str)-dict:resprequests.get(https://v1.apizero.cn/api/qq,params{qq:qq},headers{Authorization:Bearer YOUR_API_KEY},timeout10,)payloadresp.json()returnpayload[data]profileget_qq_profile(88888888)avatarprofile[avatars][s100]这样业务层只需要关心profile对象不用自己拼头像地址和空间地址。JavaScript 调用示例前端或 Node.js 中也可以直接请求constparamsnewURLSearchParams({qq:88888888,});constresawaitfetch(https://v1.apizero.cn/api/qq?${params.toString()},{headers:{Authorization:Bearer YOUR_API_KEY,},});constjsonawaitres.json();constprofilejson.data;console.log(profile.qq);console.log(profile.name);console.log(profile.mail);console.log(profile.qzone);console.log(profile.avatars.s640);如果是浏览器页面展示可以这样渲染头像divclassprofileimgidavataraltQQ avatar/dividname/divaidqzonetarget_blankQQ 空间/a/divscriptasyncfunctionrenderQQProfile(qq){constparamsnewURLSearchParams({qq});constresawaitfetch(https://v1.apizero.cn/api/qq?${params});constjsonawaitres.json();constdatajson.data;document.querySelector(#avatar).srcdata.avatars.s100;document.querySelector(#name).textContentdata.name||data.qq;document.querySelector(#qzone).hrefdata.qzone;}renderQQProfile(88888888);/script前端展示建议头像尺寸可以按场景选择场景推荐字段表格小头像avatars.s40用户列表avatars.s100资料卡片avatars.s140详情页或预览avatars.s640如果昵称为空可以用 QQ 号作为兜底展示constdisplayNamedata.name||data.qq;邮箱字段是标准拼接格式constmaildata.mail;// 88888888qq.com空间链接可以直接用于跳转constqzoneUrldata.qzone;适用场景用户资料补全用户输入 QQ 号后可以自动补全头像、邮箱和空间链接减少用户手动填写成本。客服后台客服系统里经常需要展示用户社交账号信息。接入该接口后可以用 QQ 号快速生成资料卡片。开发者工具箱很多工具站会提供 QQ 头像查询、QQ 邮箱生成、QQ 空间跳转等能力。qq接口可以作为一个完整的资料查询模块。评论和社区系统在轻量社区或内部工具里可以根据 QQ 号生成默认头像提升资料展示效果。
