开放 API
全部接口免鉴权、免费调用，支持跨域(CORS)，可直接用于你的网站与脚本
免鉴权
免费
支持跨域 CORS
JSON 响应
接口前缀统一为 /api/v1，与站点同源。响应均为 UTF-8 JSON；公开接口失败时返回
{"error":{"code","message"}}。第三方站点可直接用 fetch() 调用（响应头已带
Access-Control-Allow-Origin: *）。管理与登录相关接口不对外开放。
内容接口
镜像列表（名称、简介、标签、分类、下载地址）。支持
offset / limit 分页。公告列表（置顶优先、按日期倒序）；仅返回当前处于生效窗口内的公告。
首栏公告（单条）。未发布或已下架时返回
{"banner": null}。工具接口
优选域名清单（配置直出，不依赖上游）：四平台优选域名、优选 IP、示例前缀与
browser 可测性标记；站内「优选域名」页与首页「今日优选」均由它渲染。
自建加速节点状态：在线 / 延迟 / 近 7 天在线率（chmlfrp 节点走其公开 API，其余由本站服务器探测）。
传入 GitHub 链接，返回多条加速节点地址。仅接受 GitHub 系域名（github.com、
raw.githubusercontent.com、codeload.github.com、objects.githubusercontent.com、*.githubusercontent.com），
其它域名返回
400；每 IP 每分钟 120 次，超限 429。
优选监测看板：72 格 × 20 分钟（24 小时），按电信 / 移动 / 联通 / 海外分行返回丢包分级与平均延迟；
targets 为当前开放的监测域名（站内「优选域名」页的延迟展示使用下方的 summary 接口，本格图接口保留为开放能力）。
各优选域名最近一轮服务器探测：延迟（毫秒）、丢包率与在线状态（开放接口，每 5 分钟更新一轮）。
POST
/api/v1/ping/report
访客实测上报：
{"host": "...", "ms": 123}（ms ≤ 0 表示失联）；线路由服务端按来源 IP 判定，
匿名聚合存储、不含任何个人信息，每 IP 有速率限制。
统计接口
站点总览：总访问量、独立访客、今日 / 本月访问、下载次数、API 调用量等（仅聚合计数）。
地区访问分布（按 IP 解析到省级后聚合，不存完整 IP）。
各镜像下载量排行。
健康检查：返回服务状态与当前版本号，可用于探活。
POST
/api/v1/stats/pageview | event | api-call | download
统计上报接口（页面访问 / 业务事件 / 外部 API 调用 / 镜像下载），本站前端自动调用；
每 IP 每分钟 120 次，超限静默丢弃。请求体为 JSON，例如
{"event":"download"}。