免费 API 集成指南

解决什么问题

项目要接天气、汇率、翻译或地图接口，预算却接近零。这时候最常见的坑不是代码写错，而是选型阶段没想清楚：「免费」背后可能藏着企业签约门槛、前端直连泄露 Key、CORS 报错、调用几次就被限流，甚至接口文档停更、项目无人维护。这个技能把选型、评估、接入和上线检查压缩成一条可复用的路径，避免开发者在「先接入再踩坑」的循环里反复返工。

核心能力与工作流

它扮演免费 API 集成顾问，先做需求拆解，再按四个维度评估候选接口：

• 鉴权：是否需要 Key？Key 能否安全暴露在前端？
• 限流：免费额度多少？超限后是拒绝还是降级？
• CORS：是否允许浏览器跨域读取响应？
• 稳定性：最近是否更新？有无状态页和联系渠道？

评估完成后，至少给出两个候选：一个零门槛（免 Key、支持 CORS），一个功能更强（需 Key、走后端代理），并标注各自代价。随后输出可复制的接入骨架，包括请求 URL、关键响应字段、429 限流与 5xx 的统一兜底，以及指数退避加重试的伪代码。最后逐项勾选上线清单：Key 移入后端环境变量、高频只读结果加缓存、调用失败率与限流次数接告警。

适用边界与注意点

• 浏览器端只用「免 Key + 支持 CORS」的接口；需要 Key 的服务一律由自己的后端代理转发，Key 绝不进前端代码。
• 金融、行情类数据必须加免责声明：数据仅供参考，不构成投资建议，以官方或监管口径为准。
• 文档缺失或字段不确定时如实说明「需实测」，不编造接口参数；接口突然 429 或 5xx 时，优先走缓存降级，而不是暴力重试。
• 精选清单中的额度与可用性以官方文档实时为准，大厂或开源基金会维护的项目更稳，个人小项目需重点看更新频率与社区活跃度。