接口线路类型一[集群IP接口-免费]
[接口地址1]
：当前负载【
优】 接口通讯【
正常】
复制
测速
[接口地址2]
：当前负载【
优】 接口通讯【
正常】
复制
测速
[接口地址3]
：当前负载【
优】 接口通讯【
正常】
复制
测速
接口线路类型二[域名接口-免费]
[接口地址]
：[自动分发到集群接口均衡负载，但可能因网络运营商DNS缓存如果某个集群接口发生故障会造成个别地区有1天左右的故障期]
复制
测速
接口线路类型三[超高稳定-最低24¥/月]
[彩钻接口]
：[专属集群+普通集群+备用集群，自动负载均衡，自动故障切换，抗攻击，全球智能CDN加速。超高稳定性！]
复制
测速
请求示例
[GET]请求示例：(以下为公共KEY，共享每分钟调用频次，请登录后使用自己的KEY独享频次)
复制全部
复制参数
[POST]请求示例(请根据开发语言自行POST)
请求参数说明
注意：请求编码为UTF8，否则带中文请求可能失败。一般参数不能带+号，会被自动替换为空格。
| 名称 |
参数 |
必填 |
说明 |
| 用户ID | id | 是 | 用户中心的数字ID，例：id=10000000 |
| 用户KEY | key | 是 | 用户中心通讯秘钥，例：key=15he5h15ty854j5sr152hs2 |
| 数量 | num | 否 | 返回头像数量，默认1，最多30个，例：num=30 |
| 用户IPV4 | uip | 否 | 接口调用者IPV4，用于后台统计IP地域分布，ISP运营商，时段IP数统计等，如不传该参数则默认为接口请求端IP，该参数主要用于使用中间件请求接口的方式使用。例：uip=123.123.123.123 |
返回参数说明
| 名称 |
参数 |
说明 |
| 状态码 | code | 200成功，400错误 |
| 消息内容 | msg | 消息提示。 |
| 头像地址集 | data | 头像地址数据集。头像大小从30像素-140像素不等。 |
| 头像库数量 | maxid | 当前头像库最大头像数量，接口盒子每日入库10万+QQ头像，自动滤重，实时更新数量。 |
返回数据示例
示例：{"code":400,"msg":"通讯秘钥错误。"}
示例：
{
"code": 200,
"data": ["https://qqtx.apihz.cn/img/qqtx/1/dae/dae6317b02b7716f3e6bd516a8ca72bb.jpg", "https://qqtx.apihz.cn/img/qqtx/1/fa1/fa107db89de8ab6730f285ba02b3135c.jpg", "https://qqtx.apihz.cn/img/qqtx/1/3d2/3d22f767f69e617b25f46aca994b2b20.jpg", "https://qqtx.apihz.cn/img/qqtx/1/070/0707ebaba919a6b4d032add6b772a243.jpg", "https://qqtx.apihz.cn/img/qqtx/1/9fb/9fb9e3751cf4e3dc3d9bd244ae2d4291.jpg", "https://qqtx.apihz.cn/img/qqtx/1/8ec/8eccc1051565552d5576752145f1fe5a.jpg", "https://qqtx.apihz.cn/img/qqtx/1/c40/c408d96ecd448196acbb8a48adcd9ea3.jpg", "https://qqtx.apihz.cn/img/qqtx/1/8d9/8d9cfa4b7fef1fbc4469106622180fa9.jpg", "https://qqtx.apihz.cn/img/qqtx/1/5ea/5ea556bac1150d8879215ec889b75614.jpg", "https://qqtx.apihz.cn/img/qqtx/1/2ec/2ec6efaf31e2e4b3edc95719d9cbf1a5.jpg"],
"maxid": "1145810"
}
更新记录
2025-03-13 15:56:32 - 新增请求参数【num】，返回头像数量。默认1，最多30个。更新返回字段【data】用于存储头像数据集。2025-03-08 21:45:01 - 新增接口。
图像壁纸-随机头像图片[QQ用户头像-千万头像库]-2025-03-13 15:57:55
