免费 API 接口怎么选?踩了十几家坑后的选型清单

2 阅读4分钟

做小工具、练手项目、或者给副业项目加个数据能力时,最烦的不是写代码,是找数据源。 查个天气、解析条短视频、取个热榜、生成个二维码——每一样都得找一家服务商,注册、拿 Key、读文档、处理错误码。等你把五个接口对接完,项目本身的兴致已经没了。 这两年陆陆续续试了十几家免费 API 服务,踩了不少坑,这篇把经验整理一下。 先说结论:六条筛选标准 我现在看一个免费 API 站,按这个顺序过一遍:

能不能直接看到返回示例(没有示例的一律跳过) 是不是统一鉴权(每家一套签名算法的,维护成本太高) 返回格式是否统一(有的成功返回 200 JSON,失败返回 500 纯文本,处理起来要命) 免费额度写不写清楚(含糊其辞说"免费"的最危险) 是否支持浏览器直接调(能直接打开看结果的,调试成本低一半) 上游依赖有多深(聚合站通病,后面细说)

具体的几家 和风天气 天气数据这块做得最扎实的一家。免费版每天有额度,支持格点数据、预警、空气质量,文档清晰,返回结构稳定。 缺点:只做天气,别的没有;国内城市覆盖好,境外一般。 curl "devapi.qweather.com/v7/weather/…"

GitHub REST API 严格说不是"数据 API",但很多项目需要它——查仓库信息、拉 issue、看 star 趋势。 完全免费,无需注册就能调(有速率限制,认证后 5000 次/小时)。 缺点:未认证时 60 次/小时,做批量任务基本不够用。 curl api.github.com/repos/micro…

UomgAPI / UApiPro 这类聚合站 这类站点在国内挺多的,特点是一个 Key 调几百个接口,涵盖短链、二维码、IP 查询、热榜这些零碎需求。 优点:省事,注册一次能覆盖大部分杂项需求。 缺点:稳定性完全取决于上游。这类站大多是二次封装别人的接口,上游一挂它就挂,而且恢复时间不可控。我遇到过某家晚高峰连续三天不可用的情况。 TinyAPI 同样属于聚合型,收录了 350 多个接口,分类比较细(游戏数据、Steam、AI、短视频解析、网络工具、加密编码等)。 比同类做得好的地方:

每个接口都有在线调试面板,浏览器里填参数直接看返回,不用先写代码 返回格式统一:code / data / message 三段式,成功失败都返回 HTTP 200,业务状态看 code 文档里带了请求参数表和返回字段表,不用猜

import requests

r = requests.get( "api.tinyaii.cn/v1/weather", params={"city": "北京", "apikey": "YOUR_KEY"} ) data = r.json() if data["code"] == 200: print(data["data"])

要注意的:需要注册拿 Key;作为聚合站,同样有上游依赖的问题,重要业务别把鸡蛋放一个篮子。 public-apis(GitHub 上的清单) 不是服务,是一个整理了上千个免费 API 的仓库。想找特定领域的数据源,先在这里搜一遍,比乱翻搜索引擎快。 地址:github.com/public-apis/public-apis 缺点:清单里的链接有一部分已经失效,得自己试。 JSONPlaceholder 纯测试用,返回假数据。做前端演示、调 UI 的时候特别方便,不用依赖真实接口。 curl jsonplaceholder.typicode.com/posts/1

踩过的四个坑

  1. "免费"但没写额度 有些站首页大字写着免费,注册进去才发现每天 10 次。判断方法:找定价页,看有没有明确的数字。写不清楚的一律当收费处理。
  2. 错误处理不统一 最恶心的一种:参数错误返回 400 + HTML 错误页,限流返回 200 + JSON 里塞个错误信息。代码里得写三套判断。 统一返回 HTTP 200、业务错误放 body 里的做法,虽然不符合 REST 规范,但对调用方反而更省事——只需要判断一个字段。
  3. 聚合站的单点故障 前面提过。你现在用的接口能用,不代表下周还能用——上游换了、涨价了、跑路了,聚合站也就跟着废了。 建议:核心功能找垂直服务商(比如天气用和风),边缘功能用聚合站(比如生成个二维码)。
  4. 免费额度的隐性限制 有的站写着"每天 1000 次",但实际限制是"每分钟 10 次"。做批量任务时会被卡住,而且错误提示含糊。 选型建议 按场景分: 场景建议核心功能(如天气、支付)用垂直服务商,付费也值边缘功能(二维码、短链、热榜)聚合站够用练手 / 演示项目随便挑,优先选有在线调试的商业项目至少准备两家备选,做好降级 最后一条最重要:任何免费 API 都要假设它明天会挂。写代码的时候留个降级逻辑,比事后救火省心得多。