QQ头像获取API文档
⚠️ 使用须知： 本API可以获取任意QQ用户的头像，请严格遵守使用规范，勿用于非法用途。请求频率限制为每分钟最多30次。
如果遇到接口问题，可以在下方评论区留言或者发送邮件至：3839913185@qq.com
📋 接口基本信息
接口地址：
https://sgyyds.hebil.xyz/api/qqtx.php
请求方式：
GET
频率限制：
30次/分钟
🔧 请求参数
| 参数名 | 类型 | 是否必需 | 说明 | 示例 |
|---|---|---|---|---|
| String | ✅ 是 | 要查询的QQ号码 | 3816847927 |
🌐 请求示例
https://sgyyds.hebil.xyz/api/qqtx.php?qq=3816847927📨 返回结果
✅ 成功响应
直接返回QQ头像图片数据。
HTTP状态码: 200 OK
Content-Type: image/jpeg
❌ 错误响应
1. 缺少参数 (400 Bad Request)
{
"code": 400,
"message": "请提供QQ号参数",
"example": ""http://sgyyds.hebil.xyz/api/qqtx.php?qq=123456" (http://sgyyds.hebil.xyz/api/qqtx.php?qq=123456)"
}2. 参数格式错误 (400 Bad Request)
{
"code": 400,
"message": "QQ号格式不正确",
"input": "abc123"
}3. 未找到头像 (404 Not Found)
{
"code": 404,
"message": "未找到该QQ号对应的头像",
"qq": "9999999999"
}4. 请求频率限制 (429 Too Many Requests)
{
"code": 429,
"message": "请求过于频繁，请稍后再试",
"limit": "30次/分钟"
}💡 使用建议
- 📱 缓存策略：建议在客户端缓存获取的头像，减少API调用
- ⏱️ 频率控制：合理控制请求频率，避免触发限制
- 🔄 错误处理：妥善处理404错误，提供默认头像
- 📊 日志记录：记录API调用情况，便于问题排查
🚨 常见问题
❓ 头像更新频率是怎样的？
API返回的头像会实时更新，与QQ客户端显示的头像保持一致。
❓ 可以获取高清头像吗？
当前API返回的是标准清晰度的头像图片，如需更高清晰度请联系我们。
❓ 支持批量获取头像吗？
目前仅支持单个QQ号查询，批量查询请控制请求频率。
版权申明
本文系作者 @sgyyds 原创发布在孙哥博客站点。未经许可，禁止转载。
暂无评论数据