首页 全部接口 API文档 文章 贡献者 友链 赞助 关于
登录/注册

QQ昵称获取

GET https://apis.whrx.chat/api/qq/name.php
由 AI 生成：本文档根据接口配置自动生成，内容仅供参考，实际调用以接口返回为准。

---

接口简介

通过QQ号码快速查询该用户的公开信息，包括昵称、邮箱、多尺寸头像及QQ空间链接。适用于社交账号验证、用户资料展示等场景，接口无需鉴权即可直接调用。

---

请求说明

  • 请求地址：https://api.xunjinlu.fun/api/qq/name.php
  • HTTP 方法：GET
  • 常用请求头：
Accept: application/json（推荐显式声明）

---

请求参数表

名称类型必填说明
<code>qq</code>字符串是目标QQ号码（5~11位纯数字）

---

返回字段表

字段路径类型说明
<code>code</code>整数状态码（200表示成功）
<code>message</code>字符串响应描述
<code>data.qq</code>字符串查询的QQ号码
<code>data.nickname</code>字符串QQ昵称
<code>data.mail</code>字符串QQ邮箱地址
<code>data.avatar</code>对象头像链接集合（含4种尺寸）
<code>data.qzone_url</code>字符串QQ空间主页链接
<code>api_info</code>对象开发者及平台信息
<code>time</code>字符串响应时间（UTC+8）

---

返回 JSON 示例

成功响应： 
{
  "code": 200,
  "message": "success",
  "data": {
    "qq": "3202089153",
    "nickname": "尋鯨錄",
    "mail": "3202089153@qq.com",
    "avatar": {...},
    "qzone_url": "https://user.qzone.qq.com/3202089153"
  },
  "api_info": {...},
  "time": "2026-04-12 02:51:14"
}

失败响应： 

{

  "code": 400,

  "message": "QQ号码格式错误",

  "data": null

}

---

错误与状态

类型值/示例说明
HTTP<code>200</code>请求成功
HTTP<code>400</code>参数错误（如QQ格式无效）
业务码<code>code: 500</code>服务器内部错误
业务码<code>code: 404</code>QQ号码不存在
注：具体错误信息以返回的 message 字段为准。

---

调用示例

直接访问 

https://api.xunjinlu.fun/api/qq/name.php?qq=3202089153
浏览器中打开此URL可直接查看JSON结果。

cURL 

curl -G "https://api.xunjinlu.fun/api/qq/name.php" \
  -d "qq=3202089153" \
  -H "Accept: application/json"

Python requests 

import requests


url = "https://api.xunjinlu.fun/api/qq/name.php"

params = {"qq": "3202089153"}

response = requests.get(url, params=params)

print(response.json())

PHP 

<?php
$qq = "3202089153";
$url = "https://api.xunjinlu.fun/api/qq/name.php?qq=" . $qq;


$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, $url);

curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$result = curl_exec($ch);

curl_close($ch);



echo $result;

?>

HTML