技术文章

外部链接将在新标签页打开。

免费 API 接口怎么筛:先拆清“免费”的四种含义,再决定接入

一句话回答

“免费 API”至少要区分永久免费层、限时试用额度、按量计费中的免费额度、公共端点和可自建服务四类,各自在配额、商用许可与数据留存上差别很大。判断能否接入,要看能否留下可复现的记录,包括来源 URL 与抓取日期、端点版本、测试环境、调用窗口、成功率与延迟分位数、限流语义、账单结果和许可条件。具体服务名单、配额与价格本次没有素材,均待核实。

如果问题是要一份“免费 API 推荐清单”加“实测结论”,本文给不了:本次没有可用正文素材,也没有任何可核验的调用记录。凭空列出名单、写上“实测可用”,就是把推测写成事实。能给的是一套筛选方法:把“免费”拆成可核对的条款,把“可用”拆成可复现的记录,结论由你自己的调用记录来支撑。

一、“免费”至少是四件不同的事#

  • 永久免费层:有固定配额,超出后拒绝或转为计费,条款可能调整,需要看官方定价页与条款原文。
  • 限时试用额度或试用金:到期或额度耗尽即失效,常需绑定支付方式。
  • 按量计费中的免费额度:账单照样产生,只是前若干次被抵扣,“免费”是账单口径而不是调用口径。
  • 公共/社区端点、可自建的开源服务:前者的“免费”通常伴随严格限流且无可用性承诺;后者的“免费”指软件许可,成本转移到部署与运维。

把这四类混为一谈,最典型的错误是把“调通一次”写成“免费可用”。它们在配额、商用许可、数据留存上的差别,往往比接口本身的技术差异更影响选型。

二、先写需求,再看接口#

与厂商无关的问题先答完,否则容易被“免费”二字带走:调用量级与峰值是多少;可接受的延迟与超时是多少;是否允许把数据发给第三方、数据落在哪个区域;结果能否缓存、缓存键是什么;失败时降级到什么;是否商用、是否再分发返回数据。

其中“能否缓存”和“能否再分发”最常被忽略:部分免费层条款限制存储或二次分发返回内容,具体以各服务条款原文为准,本文不作判断。

三、“实测”要能被别人复现#

一条可复现的记录至少包含:抓取日期与来源 URL(官方文档、定价页、条款原文)、端点与版本、认证方式、测试环境(区域、网络、客户端版本)、调用次数与时间窗、成功率、延迟分位数、限流响应头与错误码语义、账单实际结果、许可条件。缺少任何一项,“实测可用”就会退化成个人印象。延迟分位数尤其需要真实测量数据,没有测量记录就不写数字。

四、记录模板(未执行的示例)#

{
  "service": "example.com(占位)",
  "docs_url": "https://example.com/docs",
  "checked_at": "YYYY-MM-DD",
  "endpoint": "https://example.com/v1/demo",
  "auth": "API Key in header(YOUR_KEY 占位)",
  "env": { "region": "占位", "client": "占位" },
  "window": { "calls": 0, "duration_s": 0 },
  "result": { "success": 0, "http_429": 0, "p50_ms": null, "p95_ms": null },
  "billing": "待核实",
  "license": "待核实"
}

以上只是字段模板,未执行,也不包含任何真实调用结果;example.com 与 YOUR_KEY 均为占位,不应替换成未经核实的真实站点请求。

五、接入时的固定动作#

  • 密钥只放服务端,前端经自己的后端转发;不要写进 H5 或小程序包。
  • 明确限流语义:429 是否带 Retry-After、退避策略、请求是否幂等;限流与计费的判定顺序要拿账单核对,不能只看响应码。
  • 先定缓存键与 TTL,再谈降级;降级路径应返回“旧值 + 标记”,而不是空结果。
  • 跟踪上游变更:订阅发布说明,定期用同一份记录重跑并比对差异。

六、本文不覆盖什么#

具体服务名单、配额数字、价格、可用性与商用许可的逐条结论,本次材料均未提供,一律待核实。请不要把本文当作选型结论或合规依据;按上面的模板对每个候选服务各跑一次,并保留原文链接与抓取日期。

作者:沐小悠

本文约 5 分钟读完 · 关键词:免费 API、API 选型、接口评估、限流与配额、可复现测试记录

更多文章 GET 示例接口

「」标签下的其他文章