API 文档

WXies Team 提供的各种实用工具 API 文档。

工具列表

工具	描述	接口地址
获取 QQ 头像	通过 QQ 号获取用户头像	`https://api.horatio.cn/avatar/qq.php`
获取 QQ 群头像	通过 QQ 群号获取群头像	`https://api.horatio.cn/avatar/qqg.php`
必应每日壁纸	获取必应每日壁纸图片	`https://api.horatio.cn/tool/bing.php`
短链服务	创建、查询与管理短链，支持自定义代码、过期与覆盖	`https://tio.fyi/api.php`

使用说明

所有工具均通过 API 接口调用，接口地址、请求方法与返回格式见各接口页的「接口信息」表。

调用方式

请求方法：读操作用 GET；短链服务的写操作用 POST（携带 JSON body）
返回格式：图片类接口返回 302 重定向到图片地址，其余返回 JSON（UTF-8）
鉴权方式：头像与壁纸接口无需鉴权，短链服务需 API 密钥
响应时间：通常 < 500ms

错误处理

HTTP 状态码	说明
`302`	成功，重定向到图片地址
`200`	成功返回 JSON；短链服务的业务错误也返回 `200` + `"success": false`
`400`	请求参数错误，返回 JSON 错误体
`403`	命中站点防火墙（WAF），返回 HTML 拦截页
`410`	短链已过期或访问次数达上限
`502`	服务器内部错误

各接口的具体错误文案与返回体见对应页面的「错误处理」表。

更新日志

2026-10-16

修正短链服务文档的「获取密钥」路径：API 密钥卡片位于短链管理页左侧栏，原文写的「短链列表底部」已不存在

2026-10-12

统一全部 API 文档结构与写法：章节顺序固定（接口信息 → 鉴权 → 调用参数 → 调用示例 → 错误处理），参数表统一为「参数 / 类型 / 必填 / 默认值 / 说明」，示例统一标签与代码块语言，规范写入项目 AGENTS.md
修正 QQ 头像与 QQ 群头像的错误行为描述：参数非法实际返回 HTTP 400 JSON，成功为 302 重定向（原文写成"返回默认头像"）
短链服务错误码补充 WAF 403 与过期 410
短链服务文档对齐当前实现：新增目标链接校验规则、密钥第四种携带方式（JSON body）、各操作返回体、过期与次数上限的 410 表现

2026-10-03

新增短链服务 API 文档与侧边栏入口

2026-07-05

添加 QQ 头像和 QQ 群头像的尺寸参数支持
优化必应壁纸接口的参数验证
完善 API 文档

注意事项

版权声明

部分代码来自互联网，如有侵权请前往 GitHub Issues 要求删除

问题反馈

遇到问题请前往 GitHub Issues 提问