public-apis 快速上手：给任何功能找到能用的 API 只要 10 分钟

public-apis 快速上手：给任何功能找到能用的 API 只要 10 分钟

【免费下载链接】public-apisA collective list of free APIs项目地址: https://gitcode.com/GitHub_Trending/pu/public-apis

需要天气数据这类功能时，你通常会卡在"接口从哪里来"上。public-apis 是一个由社区维护的开源 API 资源库，数百个免费公开接口全装在一份 README 表格里。打开就能查，不用注册。

一个让你卡住的场景

做小应用时你需要一个查天气的接口，搜到一篇教程，接口已经三年没更新，一调就是 404；换一个要注册账号，还不确定有没有免费额度。正常流程下，你每换一个功能，都要重新经历一遍搜索、验证、注册。public-apis 把这件事前置了：接口按类别整理好，每一行都标注了认证方式、是否支持 HTTPS、是否支持 CORS，你在表格里就能划掉一批不合适的。

public-apis 快速上手：从克隆到找到第一个 API

先把项目拉到本地，顺手装好验证脚本的依赖：

git clone https://gitcode.com/GitHub_Trending/pu/public-apis cd public-apis pip install -r scripts/requirements.txt

第二条进项目目录，第三条安装的是scripts/requirements.txt里列出的 requests 等依赖，后面跑链接检查脚本会用到。

主文档在README.md。文件开头是一张 Index 目录，从 Animals、Anime 到 Weather、Transportation 有 40 多个分类。点目录跳到对应表格，每一行是一个 API：Auth 一列写着认证方式（apiKey、OAuth 或 No），HTTPS 和 CORS 两列各是 Yes/No。想接一个天气功能，跳到 Weather 分类，找 Auth 为 No 的那几行。

挑中之后先用一行 curl 确认它现在还能用。拿一个不用 key 的猫图片接口举例：

curl -o /dev/null -s -w "%{time_total}" https://dog.ceo/api/breeds/image/random

输出一个类似 0.41 的数字，就是接口响应耗时（秒），说明接口活着。接下来去它的文档页注册密钥，按文档示例把请求写进你的项目。

3 个让效率翻倍的用法

按类别 5 秒定位目标接口

README 有两千多行，别从头翻。Ctrl+F 搜分类名，或者在顶部 Index 里点链接，直接落到对应表格。做旅行应用跳 Geocoding，做健身应用跳 Sports & Fitness。表格内先排除 Auth 列写着 apiKey 或 OAuth 的行，Auth 为 No 的接口不用注册就能调，适合先跑通再谈优化。

用一行 curl 验证 API 是否还活着

社区维护的目录不保证每个接口今天都活着。选中一个候选接口，先用上面的 curl 命令打一次：输出数字说明它还在线，返回 404 或连不上就直接划掉换下一行。需要 key 的接口，先去文档页确认有免费额度再注册，省得注册完发现额度少得没用。

一条命令找出重复和失效链接

项目自带scripts/validate/里的校验脚本，不用自己写检查逻辑。跑python scripts/validate/format.py README.md可以核对整个表格的条目格式是否合规；跑python scripts/validate/links.py README.md -odlc只查重复链接，比逐条验证所有链接快得多。想确认目录现状，这两个命令就够用。

参与维护

发现表里接口失效了，直接去仓库提 Issue；想加新 API，先看 CONTRIBUTING.md 里的提交标准，新增条目要过 校验脚本 的格式和链接检查再提 pull request。

现在就打开README.md，跳到 Weather 分类，挑一个 Auth 为 No 的接口用 curl 调一次。如果发现它已经死了，这就是你的第一个维护任务。

【免费下载链接】public-apisA collective list of free APIs项目地址: https://gitcode.com/GitHub_Trending/pu/public-apis