JavaScript 调用 QQ 信息接口：头像直链和 QQ 空间链接展示

做用户资料补全、社交账号展示、头像回填或开发者工具箱时，经常会遇到一个轻量需求：输入一个 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

请求参数：

请求头：

最简单的请求示例：

curl"https://v1.apizero.cn/api/qq?qq=88888888"

带鉴权头的请求示例：

curl"https://v1.apizero.cn/api/qq?qq=88888888"\-H"Authorization: Bearer YOUR_API_KEY"

返回字段

接口返回结构比较适合前端直接消费：

返回示例

{"code":0,"msg":"成功","data":{"qq":"88888888","name":"","mail":"88888888@qq.com","qzone":"https://user.qzone.qq.com/88888888","avatars":{"s40":"https://q1.qlogo.cn/g?b=qq&nk=88888888&s=40","s100":"https://q1.qlogo.cn/g?b=qq&nk=88888888&s=100","s140":"https://q1.qlogo.cn/g?b=qq&nk=88888888&s=140","s640":"https://q1.qlogo.cn/g?b=qq&nk=88888888&s=640"},"is_found":true},"request_id":"mpl8a642714dcb60"}

如果页面上只需要头像，一般优先使用：

data.avatars.s100

如果是资料详情页或高清头像预览，可以使用：

data.avatars.s640

Python 调用示例

下面是一个最小可用的 Python 示例：

importrequests url="https://v1.apizero.cn/api/qq"params={"qq":"88888888"}headers={"Authorization":"Bearer YOUR_API_KEY"}resp=requests.get(url,params=params,headers=headers,timeout=10)result=resp.json()data=result["data"]print("QQ:",data["qq"])print("昵称:",data["name"])print("邮箱:",data["mail"])print("空间:",data["qzone"])print("高清头像:",data["avatars"]["s640"])

如果要把接口接到后端服务里，可以封装成一个函数：

importrequestsdefget_qq_profile(qq:str)->dict:resp=requests.get("https://v1.apizero.cn/api/qq",params={"qq":qq},headers={"Authorization":"Bearer YOUR_API_KEY"},timeout=10,)payload=resp.json()returnpayload["data"]profile=get_qq_profile("88888888")avatar=profile["avatars"]["s100"]

这样业务层只需要关心profile对象，不用自己拼头像地址和空间地址。

JavaScript 调用示例

前端或 Node.js 中也可以直接请求：

constparams=newURLSearchParams({qq:"88888888",});constres=awaitfetch(`https://v1.apizero.cn/api/qq?${params.toString()}`,{headers:{Authorization:"Bearer YOUR_API_KEY",},});constjson=awaitres.json();constprofile=json.data;console.log(profile.qq);console.log(profile.name);console.log(profile.mail);console.log(profile.qzone);console.log(profile.avatars.s640);

如果是浏览器页面展示，可以这样渲染头像：

<divclass="profile"><imgid="avatar"alt="QQ avatar"/><divid="name"></div><aid="qzone"target="_blank">QQ 空间</a></div><script>asyncfunctionrenderQQProfile(qq){constparams=newURLSearchParams({qq});constres=awaitfetch(`https://v1.apizero.cn/api/qq?${params}`);constjson=awaitres.json();constdata=json.data;document.querySelector("#avatar").src=data.avatars.s100;document.querySelector("#name").textContent=data.name||data.qq;document.querySelector("#qzone").href=data.qzone;}renderQQProfile("88888888");</script>

前端展示建议

头像尺寸可以按场景选择：

如果昵称为空，可以用 QQ 号作为兜底展示：

constdisplayName=data.name||data.qq;

邮箱字段是标准拼接格式：

constmail=data.mail;// 88888888@qq.com

空间链接可以直接用于跳转：

constqzoneUrl=data.qzone;

适用场景

用户资料补全

用户输入 QQ 号后，可以自动补全头像、邮箱和空间链接，减少用户手动填写成本。

客服后台

客服系统里经常需要展示用户社交账号信息。接入该接口后，可以用 QQ 号快速生成资料卡片。

开发者工具箱

很多工具站会提供 QQ 头像查询、QQ 邮箱生成、QQ 空间跳转等能力。qq接口可以作为一个完整的资料查询模块。

评论和社区系统

在轻量社区或内部工具里，可以根据 QQ 号生成默认头像，提升资料展示效果。