Add project metadata and docs

新增工具文档/查询 QQ 信息.md

@@ -0,0 +1,258 @@
+\---
+
+title: "查询 QQ 信息"
+
+locale: zh-CN
+
+canonical: https://uapis.cn/docs/api-reference/get-social-qq-userinfo
+
+source: https://uapis.cn/docs/api-reference/get-social-qq-userinfo.md
+
+\---
+
+
+
+\# 查询 QQ 信息
+
+
+
+\*\*分类：\*\* 社交
+
+
+
+通过 QQ 号查询用户资料，返回头像、昵称、个性签名、等级和 VIP 信息。
+
+
+
+\## 功能概述
+
+这个接口适合用在用户资料展示、头像卡片、账号绑定结果展示等场景。若用户把 QQ 等级设为隐藏，`qq\_level` 会返回 `null`。
+
+
+
+\## 数据字段说明
+
+\- \*\*基础信息\*\*: 昵称、个性签名、头像、年龄、性别
+
+\- \*\*联系信息\*\*: QQ 邮箱、个性域名（QID）
+
+\- \*\*等级信息\*\*: QQ 等级、VIP 状态和等级
+
+\- \*\*时间信息\*\*: 注册时间、最后更新时间
+
+
+
+\## API 端点
+
+
+
+\*\*方法：\*\* GET
+
+\*\*路径：\*\* /social/qq/userinfo
+
+\*\*完整API地址：\*\* https://uapis.cn/api/v1/social/qq/userinfo
+
+\*\*文档页面：\*\* https://uapis.cn/docs/api-reference/get-social-qq-userinfo
+
+
+
+\## 响应
+
+
+
+\### 200 / 请求成功
+
+
+
+成功响应，返回QQ用户的详细信息
+
+
+
+```json
+
+{
+
+  // QQ号
+
+  "qq": "10001",
+
+  // 用户昵称
+
+  "nickname": "小明",
+
+  // 个性签名
+
+  "long\_nick": "今天天气真不错",
+
+  // 头像URL
+
+  "avatar\_url": "http://q.qlogo.cn/g?b=qq\&nk=10001\&s=640",
+
+  // 年龄
+
+  "age": 25,
+
+  // 性别
+
+  "sex": "男",
+
+  // QQ个性域名
+
+  "qid": "xiaoming2024",
+
+  // QQ等级。用户隐藏时返回 null
+
+  "qq\_level": 64,
+
+  // 地理位置（省市）
+
+  "location": "广东 深圳",
+
+  // QQ邮箱
+
+  "email": "10001@qq.com",
+
+  // 是否为VIP用户
+
+  "is\_vip": true,
+
+  // 是否为年费VIP用户
+
+  "is\_years\_vip": true,
+
+  // 是否为SVIP用户
+
+  "is\_svip": false,
+
+  // 是否为QQ大会员用户
+
+  "is\_big\_club": true,
+
+  // 会员开通状态
+
+  "vip\_status": 1,
+
+  // 会员类型
+
+  "vip\_type": 3,
+
+  // VIP等级
+
+  "vip\_level": 7,
+
+  // QQ大会员等级
+
+  "big\_club\_level": 1,
+
+  // 黄钻等级（可选）
+
+  "yellow\_diamond\_level": 10,
+
+  // 绿钻等级（可选）
+
+  "green\_diamond\_level": 9,
+
+  // 腾讯影视会员等级（可选）
+
+  "video\_vip\_level": 7,
+
+  // 情侣/恋人类会员等级（可选）
+
+  "lover\_vip\_level": 2,
+
+  // 部分特权图标状态
+
+  "privilege\_icons": {
+
+    // VIP图标是否点亮
+
+    "vip": true,
+
+    // SVIP图标是否点亮
+
+    "svip": false,
+
+    // 年费VIP图标是否点亮
+
+    "years\_vip": true,
+
+    // QQ大会员图标是否点亮
+
+    "big\_club": true
+
+  },
+
+  // 注册时间（ISO 8601格式）
+
+  "reg\_time": "2008-03-15T10:30:00Z",
+
+  // 最后更新时间（ISO 8601格式）
+
+  "last\_updated": "2024-08-14T15:45:30Z"
+
+}
+
+```
+
+
+
+\### 400 / 错误的请求
+
+
+
+缺少或无效的qq参数
+
+
+
+```json
+
+{
+
+  "code": "INVALID\_ARGUMENT",
+
+  "details": {},
+
+  "message": "Missing or invalid 'qq' parameter."
+
+}
+
+```
+
+
+
+\### 404 / 未找到
+
+
+
+获取QQ用户信息失败或用户不存在
+
+
+
+```json
+
+{
+
+  "code": "NOT\_FOUND",
+
+  "details": {},
+
+  "message": "Failed to retrieve QQ user info, user may not exist."
+
+}
+
+```
+
+
+
+\## 查询参数
+
+
+
+\- \*\*`qq`\*\* (string) - 必填
+
+  需要查询的QQ号
+
+  示例：`10001`
+
+  提示：纯数字的QQ号。
+