public-apis 快速上手指南40 类免费公开 API三步跑起来【免费下载链接】public-apisA collective list of free APIs项目地址: https://gitcode.com/GitHub_Trending/pu/public-apis给 App 加个天气功能你打算自己抓数据还是直接找个现成的公开接口public-apis 就是一个社区维护的免费公开 API 列表把分散在几十个平台的接口收进一本可检索的目录每条都标好认证方式、HTTPS 和 CORS帮你把找接口这步从几天压缩到几分钟。这是什么一本可检索的公开 API 目录很多人第一次接触 public-apis以为是又一个链接合集。它其实是一套有固定结构的资源库——所有条目都按统一的五列表格组织你能横向对比同一类 API 的差异。整个 API 库就是一份 README.md打开项目根目录的README.md顶部有一张 40 多个类别的 Index 目录从 Animals、Anime 到 Finance、Weather基本覆盖常见开发场景。做地图功能跳 Geocoding做支付看 Finance做聊天彩蛋去 Animals 找 Cat Facts 或 Dogs不用再去各个平台翻文档。每条 API 五列信息扫一眼就能比较每个条目固定五列API 名称带官方文档链接、Description、Auth、HTTPS、CORS。Auth 列只接受几种固定写法——No、apiKey、OAuth、X-Mashape-Key、User-Agent所以你能直接看出接入成本标No的拿去就能调标apiKey的先注册拿 key标OAuth的要做完整授权流程。CORS 列标No的接口只能放在服务端调用前端直连会跨域失败。三步本地跑起来 第一步克隆仓库git clone https://gitcode.com/GitHub_Trending/pu/public-apis cd public-apis第二步安装验证脚本的依赖scripts/requirements.txt里只列了 requests 等几个包用来支撑后面的链接与格式校验python -m pip install -r scripts/requirements.txt第三步浏览并搜索列表本地化之后的好处是断网也能查。找接口有两个办法顺着 Index 目录定位类别或直接在README.md里全文搜索关键词比如weather、crypto。仓库里还有一份scripts/README.md记录了验证脚本和单元测试的完整用法动手跑脚本前可以翻一眼。三条硬指标筛出候选 API同一类别下经常有十几个接口怎么从几十条里缩到两三个按下面三条硬指标逐轮过滤。指标一先按类别锁定方向用 Index 跳到对应章节把明显不相关的条目排除。比如做股票看板就在 Finance 里看不用管 Animals 里的猫猫狗狗。指标二HTTPS 和 CORS 锁定部署环境你的应用要接敏感数据HTTPS 必须是 Yes接口要由浏览器前端直接调用CORS 必须标 Yes。这两列是表格里的硬标识不满足就直接划掉。指标三Auth 字段锁定开发成本时间紧就先找No项目需要安全边界就选apiKey团队有能力做完整授权流程再考虑OAuth。三轮筛完通常只剩 2~3 个候选。接入前做一次试射候选定了之后用一条 curl 测一下响应速度再花几分钟把官方文档翻一遍端点说明、参数示例、错误码是否齐全。响应时间稳定、文档完整的才值得写进生产代码。curl -o /dev/null -s -w %{time_total} https://dog.ceo/api/breeds/image/random提交前先跑两个验证脚本 ✅无论是修条目还是加新 API仓库自带了校验工具都在scripts/validate/目录下。在仓库根目录执行格式验证检查条目结构是否合规python scripts/validate/format.py README.md它会检查表格列数、Auth/CORS 字段的取值是否符合规范列宽是否用空格补齐。格式不对的 PR 会被构建直接拦下。链接验证批量排查失效链接python scripts/validate/links.py README.md链接数量多全量检查比较慢如果只想快速排查重复链接可以加参数python scripts/validate/links.py README.md -odlc参与社区提交规则与避坑 ⚠️CONTRIBUTING.md写了完整的贡献指南这里提炼几条最容易踩的坑。提交前三条红线一是 API 必须有完整的免费访问或免费额度且不能依赖购买硬件或服务二是列表不是营销渠道推广自家付费产品的 PR 会被拒三是每个 PR 只加一个链接条目按所在章节的字母顺序插入描述不超过 100 字符。PR 标题与提交信息有固定格式PR 标题必须写成Add Api-name API这种形式比如Add Blockchain APIcommit 信息要写清改动内容❌Update Readme.md✔Add Blockchain API to Cryptocurrency。另外两个命名小规矩API 名字里不带顶级域名写 Gmail 不写 Gmail.com也不要以 API 结尾。提交前记得 squash 所有 commit并确保构建里的链接校验通过。现在就动手打开README.md挑一个你当前项目最想用的类别找一个 Auth 标No的接口用上面那条 curl 模板打一发试试如果手边正好有个没上榜的好接口fork 仓库、按CONTRIBUTING.md加一条、跑完两个验证脚本提第一个 PR。【免费下载链接】public-apisA collective list of free APIs项目地址: https://gitcode.com/GitHub_Trending/pu/public-apis创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考