技术文章

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

免费 API 接口推荐与实测:在没有可核验记录时,先写好核对清单

一句话回答

本次没有可用正文和调用记录,因此不给出免费 API 推荐清单,也不声称实测。文章改为交付两样可复用的东西:判断“免费”是否成立的核对项(额度口径、认证与密钥、授权条款、变更策略),以及把一次调用写成他人可复现记录所需的最小字段与一个未执行的最小脚本。

直接回答标题:本文不提供“免费 API 接口推荐清单”,也不声称做过实测。本次写作没有可用的正文材料,也没有任何可核验的调用记录(环境、请求、响应、时间)。在这种情况下给出“推荐”或“实测可用”的结论,等于把传闻写成事实。可以交付的是核对方法:一套判断“免费”是否成立的检查项,以及把一次调用写成别人能复现的记录所需的最小字段。

先让“核对”取代“推荐”#

“免费 API”这句话里,“免费”至少涉及四件事:额度、限流、授权、可持续性。任何一项不明,“免费”就只是宣传语,而不是接入条件。摘要级信息不足以支撑其中任何一条,所以本文把范围缩小到“怎么查”,不延伸到“选哪家”。

接入前的四项核对#

  • 额度口径:记录单位(次/请求/令牌)、时间窗(每分钟、每天、每月)、是否按 IP 或按密钥计算,以及是否存在未登录与登录两套额度。缺少时间窗和比较基期的数字无法比较,只能记为待核实。
  • 认证与密钥暴露面:确认密钥放在哪个 Header 或 query 参数、是否支持服务端专用密钥、前端直连是否被允许。浏览器或小程序里出现的密钥等于公开密钥。
  • 授权与条款:商用是否允许、是否要求署名、返回数据的再分发与缓存边界、是否保留日志。这些通常写在服务条款而非接口文档里,两处都要看。
  • 变更与下线策略:是否有版本号、废弃公告渠道与提前期。没有版本策略的接口,升级会直接落在调用方身上。

把一次调用写成可复现的记录#

要在团队内说“这个接口能用”,至少留下下表的字段。示例列是占位写法,不是观测结果;凡是没测过的格子,写“待核实”比填一个好看的数字更有用。

字段说明示例(占位)
端点与方法完整 URL 与 HTTP 方法https://api.example.com/v1/items
认证方式Header 名与密钥来源Authorization: Bearer YOUR_KEY
环境客户端与版本、网络位置、调用时间待核实
请求形态参数位置(query / body)与 Content-Typeapplication/json
成功判据状态码之外还要检查的响应字段2xx 且响应体含 id
额度观测响应头中的限流字段X-RateLimit-Remaining(示例名)
失败样本至少一条 4xx/5xx 与完整错误包络待核实

一个最小的连通性脚本(未执行)#

下面的示例未实际运行,域名与密钥均为占位(example.com、YOUR_KEY)。它只验证“请求能不能通、返回什么状态码和内容类型”,不能证明额度、稳定性或条款允许。

# 未执行的示例;占位域名与密钥,请勿直接对真实服务发起请求
import time
import requests

url = "https://api.example.com/v1/items"
headers = {"Authorization": "Bearer YOUR_KEY"}

start = time.monotonic()
resp = requests.get(url, headers=headers, timeout=10)
elapsed = time.monotonic() - start

print("status:", resp.status_code)
print("content-type:", resp.headers.get("Content-Type"))
print("elapsed_s:", round(elapsed, 3))
print("body_head:", resp.text[:200])

注意两点:单次耗时受网络与地域影响,不能当作性能指标;状态码 200 也不等于业务成功,很多接口把错误放在响应体里返回。

常见误判#

  • 把一次成功当成稳定性证据。缺少时间窗与调用次数的“稳定”没有意义。
  • 把“无需密钥”当成可公开调用。有些接口改用 Referer、User-Agent 或来源域名做限制。
  • 用平均值代替分布。限流触发往往发生在峰值,而不是平均值。
  • 把文档里的额度当成实际额度,未在响应头或控制台侧核对。
未核实的事项不写成结论;“本次材料没有提供”也不等于“发布方没有说明”。两者都要如实区分。

把上面的表补齐之后,“推荐”才有依据;在补齐之前,任何免费 API 清单都只是候选列表,而不是接入方案。

作者:沐小悠

本文约 5 分钟读完 · 关键词:免费 API 接口、API 选型核对、限流与额度、接口实测记录、API 密钥安全

更多文章 GET 示例接口

「」标签下的其他文章