QQ头像 API

智能缓存的头像获取服务

API说明

本API提供QQ头像获取服务，支持多种尺寸和返回格式，具备智能缓存机制和自动重试功能。

请求方式

GET

API地址

http://api.00y.me/api/qq/tp.php

请求参数

qq - 必填，5-11位有效QQ号码
size - 可选尺寸：40/100/140/640（默认640）
type - 返回类型：url（默认返回URL）或 image（直接返回图片）

使用示例

# 返回URL格式 http://api.00y.me/api/qq/tp.php?qq=123456 # 直接显示图片 http://api.00y.me/api/qq/tp.php?qq=123456&type=image # 指定尺寸 http://api.00y.me/api/qq/tp.php?qq=123456&size=100&type=image

响应示例

当type=url时返回： api.00y.me/api/qq/tp/123456_640.jpg 当type=image时直接返回JPEG图片

技术特性

智能缓存：首次请求后缓存30天
自动验证：自动检测无效头像并重新获取
多尺寸支持：覆盖主流头像尺寸需求
HTTPS支持：全链路加密传输

版本信息

API版本：v2.1.0
最后更新：2024-03-20
缓存策略：30天自动更新

必填参数：qq（5-11位数字）

可选尺寸：40/100/140/640px

错误代码

400：参数格式错误
404：头像未找到
500：服务器内部错误

缓存策略

• 浏览器缓存：30天
• 服务端验证：每日自动检查
• 无效缓存：自动清除

联系我们

邮箱：2142648176@qq.com
QQ：2142648176
官网：http://api.00y.me
文档更新：实时同步GitHub