QQ 信息

概述

通过 QQ 号查询昵称、QQ 邮箱、QQ 空间链接，并生成 4 种尺寸的头像直链 URL（s40/s100/s140/s640）。 • 严格 5-11 位数字校验（防服务字符串截断引起的号码错位） • 安全增强：服务返回的 QQ key 必须与请求严格一致，否则视为未查询到 • 错误兼容：自动识别服务错误响应（_Callback({error:...})）和正常响应（portraitCallBack(...)） • 编码兜底：腾讯接口历史输出 GBK 含中文昵称时自动转 UTF-8 • 多尺寸头像：avatars 对象内含 s40/s100/s140/s640 四种尺寸 URL，前端 `<img src={data.avatars.s640}>` 直接用

鉴权

匿名每日 50 次、QPS 3；登录用户每日 300 次、QPS 10（全部免费）。命中缓存（6 小时）不计入服务配额。

获取 API Key：获取 API Key/account/keys

请求参数

GET · QUERY STRING · https://v1.apizero.cn/api/qq?qq=88888888

返回结果

顶层固定为 code / msg / data。下表一般是 data 内字段。 code · msg · data · tips · request_id

返回示例

{
  "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": "abc123def456",
  "tips": "极数本源 · https://apizero.cn"
}

请求示例

示例都是服务端写法。Python / JavaScript 各有常规写法和官方库。

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

错误码

先看业务 code。HTTP 也可能不是 200。

调用限制

购买套餐、看评价请走商城详情。 购买 / 调试

更新日志

• 1.0.02026-05-06

  首次上线，对接腾讯 cgi_get_portrait.fcg 公开接口 QQ 号严格 5-11 位数字校验，防服务字符串截断引起的号码错位 安全增强：服务返回 key 必须与请求 QQ 严格一致，否则返回 is_found=false jsonp 响应正则解析（兼容 portraitCallBack/_Callback 两种前缀），不再硬编码 substr GBK/GB18030 编码兜底，自动转 UTF-8，避免中文昵称乱码 响应字段标准化：avatars 嵌套对象（s40/s100/s140/s640），前端直接 .s640 取高清图 不存在或已注销的 QQ 返回 is_found=false（缓存 10 分钟），其他成功结果缓存 6 小时 去除源码 type=img 二进制透传模式（QQ 头像 URL 本身公开，前端直接 <img src=avatars.s640> 即可）

免责声明