基本信息
接口名称：
QQ高清头像获取
请求方法：
GET
计费类型：
免费
接口文档
# API 文档
## 接口说明
QQ 头像获取服务（平台统一入口）
## 请求地址
`/api/qqavatar`
## 请求方法
`GET`
## 请求参数
| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| qq | string | 是 | QQ 号码（5-11 位数字，首位非 0） |
| size | int | 否 | 头像尺寸，0-640 像素，0 为默认（≈100px），超出范围自动取 0 |
| format | string | 否 | 返回格式，`image`（默认）直接返回图片流，`json` 返回结构化数据 |
| action | string | 否 | 固定填 `health`，用于 Uptime 监控，此时无需 qq 参数 |
## 响应示例（format=json）
```json
{
"code": 200,
"message": "success",
"data": {
"qq": "123456",
"size": 200,
"avatar_url": "https://q1.qlogo.cn/g?b=qq&nk=123456&s=200",
"size_tips": "尺寸范围 0-640，0 为默认尺寸（约 100px）"
},
"trace_id": "xxxxxx"
}
```
## 错误码说明
| HTTP 状态 | 错误提示 | 含义 |
|-----------|----------|------|
| 400 | QQ 号码格式错误 | qq 参数缺失或格式不符合 |
| 404 | QQ 头像获取失败 | 号码无头像或接口未返回 200 |
| 200 | 获取成功 | 图片流或 JSON 正常返回 |
## 使用示例
1. 直接获取 200px 头像图
```
https://api.logoi.cn/api/qqavatar?qq=123456&size=200
```
返回：图片二进制流（Content-Type: image/jpeg）
2. 获取 JSON 详情
```
https://api.logoi.cn/api/qqavatar?qq=123456&format=json&size=640
```
返回：见上方「响应示例」
请求参数
| 参数名 | 是否必填 | 类型 | 参数说明 | 示例值 |
|---|---|---|---|---|
| 是 | string | QQ 号码（5-11 位数字，首位非 0） | 10001 | |
| size | 否 | number | 头像尺寸，0-640 像素，0 为默认（≈100px），超出范围自动取 0 | 640 |
| format | 否 | string | 返回格式，image（默认）直接返回图片流，json 返回结构化数据 | json |
请求示例
{
"qq": "10001",
"size": 640,
"format": "json"
}
返回参数
| 参数名 | 类型 | 说明 |
|---|
返回示例
[]