Skip to content
Shabby-666Public

About

全网免费 API 中转站:一个域名调用 120+ 免 Key 公共接口

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Latest commit

 

History

40 Commits

Folders and files

Repository files navigation

API Router · 全网免费 API 中转站

一个域名,调用全网免费 API。免 Key、统一 CORS、统一缓存、在线调试。

API Router 把散落在全网的公共接口(随机图片、今日天气、网易云音乐、微博热搜、汇率行情、IP 归属地、论文检索、本地工具……)收敛成统一的 /api/r/:id 形式,并补上缓存、超时、编码转换与错误兜底。

  • 140 个接口 / 9 大分类,全部无需注册、无需 API Key
  • 亮 / 暗双主题,默认跟随系统,也可手动切换并记住选择
  • 内置调试台:参数表单、真实响应、cURL / JavaScript / Python 代码一键复制
  • 上游健康监测:实时探测可用性,坏接口一眼可见
  • 默认 302 重定向到上游:由客户端直连上游,避免服务器出口 IP 被上游拦截;白名单地址仍由服务端生成,天然免疫 SSRF
  • 本地工具/需加工接口自动走服务端处理:本地工具及需要响应加工、字段提取等场景由服务端处理
  • GBK 自动转码、JSON 字段提取、图片流式回传
  • 零依赖、零构建,静态页 + 3 个 Serverless Function

快速开始

本地运行

npm run dev
# → http://localhost:3000

本地开发服务器用原生 Node 模拟 Vercel 的静态站点 + Functions,不需要安装任何依赖。

部署到 Vercel

npm i -g vercel
vercel --prod

也可以直接把仓库推到 GitHub,在 Vercel 里 Import Project,框架选择 Other,无需任何环境变量与构建命令。

调用方式

# 随机一言
curl -s "https://your-app.vercel.app/api/r/hitokoto"

# 今日天气(北京)
curl -s "https://your-app.vercel.app/api/r/weather?latitude=39.9042&longitude=116.4074&current=temperature_2m,weather_code&timezone=Asia/Shanghai"

# 随机二次元图片(直接返回图片流)
curl -sL "https://your-app.vercel.app/api/r/alcy-image?style=ycy" -o anime.webp

# 网易云搜索
curl -s "https://your-app.vercel.app/api/r/netease-search?keywords=晴天&limit=5"

# 免费发信(自定义收件人、主题、正文)
curl -s "https://your-app.vercel.app/api/r/[email protected]&subject=测试邮件&body=这是一封测试邮件&from_name=API%20Router"

# 只取返回 JSON 里的某个字段
curl -s "https://your-app.vercel.app/api/r/netease-search?keywords=晴天&__pick=data.songs.0.name"

调用模式说明

  • 默认重定向:大多数接口返回 302 并跳转到真实上游地址,由调用方直接请求上游(可规避服务端 IP 被拦截)。
  • 服务端处理/代理:本地工具(如 UUID/哈希/时间戳等)、需要服务端加工响应的接口、使用 __pick 提取字段,或显式传 __proxy=1 时,由本站发起上游请求并返回处理后的结果。
  • 注意:重定向模式下,CORS、响应格式、错误结构与响应头由上游决定;如需稳定的跨域与统一响应行为,可使用 __proxy=1(但可能受上游对服务器 IP 的限制)。

通用参数

参数 说明
__pick=path.to.field 提取 JSON 字段,支持点号与数组下标
__raw=1 跳过本站加工,返回上游原始响应
__download=1 以附件形式下载图片 / 文件
其他任意参数 原样透传给上游,字段名见接口卡片
缺省参数 未传的参数会自动套用示例值,所以 /api/r/weather 也能直接返回北京天气

响应头

默认重定向模式下,浏览器/客户端会直接收到上游响应;X-Router-* 等响应头主要在服务端处理/代理模式(本地工具、需加工接口或 __proxy=1)下返回。

响应头 说明
X-Router-Status 上游 HTTP 状态码
X-Router-Latency 上游耗时(毫秒)
X-Router-Upstream 实际请求的上游域名
X-Router-RateLimit-Remaining 当前限流窗口剩余额度

限流:120 次 / 分钟 / IP,内存窗口限流,Serverless 多实例下为尽力而为。

接口分类

分类 数量 代表接口
随机图片 19 Lorem Picsum、必应每日壁纸、二次元/樱道/MtF 随机图、猫 / 狗 / 狐狸 / 鸭鸭 / Random Dog、咖啡图、随机头像、Imgflip Meme 模板、二维码、条形码、占位图
天气环境 8 Open-Meteo 实时 / 预报、空气质量、地理编码、wttr.in、海洋海浪、美国气象局、日出日落
文字文艺 28 一言、今日诗词、Wikipedia 摘要、Open Library 检索、名言 / 笑话 / 建议、词典、Datamuse、翻译、网页 Markdown、名字猜性别 / 年龄 / 国籍、圣经查询
音乐 8 网易云搜索、歌曲详情、歌词、热评、排行榜、歌单、新歌推荐、播放地址
开发者 24 GitHub、npm、Hacker News、JSONPlaceholder、DummyJSON、HTTPBin、Wayback 存档查询、短链接、真随机数、IP 查询、世界时间、arXiv、Crossref、世界银行数据、免费发信 API
金融行情 6 实时 / 历史汇率、全球牌价、CoinGecko、币安行情、A 股实时行情
生活资讯 30 每天 60 秒、热搜榜、法定节假日、REST Countries、Open Trivia、菜谱/鸡尾酒、艺术藏品、食品条码、邮编/酒厂/大学检索、水果信息、英国银行假日、ISS/地震/SpaceX、大都会博物馆
二次元 2 Jikan 动漫数据库、宝可梦图鉴
本地工具 15 UUID、哈希、Base64、时间戳、密码、随机数、配色、Lorem、URL 编解码、JSON 格式化、MC 服务器状态查询(JSON)、MC MOTD/应用卡片图(多主题与样式)

完整清单与实时参数请访问站点首页,或直接请求 GET /api。

项目结构

.
├── api/
│   ├── index.js          # GET /api         接口清单
│   ├── health.js         # GET /api/health  上游健康检查
│   └── r/[id].js         # GET /api/r/:id   中转核心
├── lib/
│   ├── registry.js       # 接口注册表(新增接口只改这里)
│   ├── proxy.js          # URL 拼装 / 请求 / 响应
│   ├── processors.js     # 上游 JSON 加工(网易云、必应、腾讯行情)
│   ├── local.js          # 本地工具实现
│   └── http.js           # CORS / 限流 / 响应工具
├── assets/               # 样式、脚本、图标
├── index.html            # 单页站点
├── dev.mjs               # 本地开发服务器
└── vercel.json

新增一个接口

编辑 lib/registry.js,在 endpoints 里追加:

{
  id: 'my-api',
  name: '我的接口',
  category: 'dev',
  icon: '🧩',
  desc: '一句话介绍',
  upstream: 'https://api.example.com/path/{param}',
  ttl: 300,
  docs: 'https://api.example.com/docs',
  tags: ['免Key'],
  params: [
    { key: 'param', label: '参数', example: 'hello', desc: '参数说明', required: true },
  ],
}

保存后 /api、健康检查、前端目录与调试台会自动更新。

说明

  • 本项目只做技术中转,不存储任何上游数据,接口版权与可用性归各上游服务所有。
  • 公共免费接口随时可能变更、限流或下线;页面上的健康状态就是为此准备的。
  • 请遵守各上游服务条款,不要用于商业转售、爬虫轰炸或违法用途。
  • 部分接口(网易云播放地址、CoinGecko、Binance 等)对地区或频率有限制,海外 / 高并发场景请自建缓存。

License

MIT

About

全网免费 API 中转站:一个域名调用 120+ 免 Key 公共接口

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages