4.2亿开发者沉默背后：API工具这10年其实在开倒车

全球开发者每天在API调用上花费47分钟，其中31分钟花在"让这东西跑起来"上。这个数字来自Postman 2024年度报告，比三年前还多了4分钟。

我们明明有了Swagger、OpenAPI、GraphQL、gRPC，有了能自动生成代码的AI。但API工作的核心体验，和2015年相比几乎没变：读完文档、试几个请求、发现实际行为不符、在Slack里@后端同事、等待、再试。

AI把文档问题解决了，却把更深层的麻烦暴露出来。

文档泡沫被戳破后， workflow（工作流）成了裸泳者

「AI能解释API、生成payload、对比版本、写客户端，比大多数人类流程快得多。」这是原文作者的原话。他做了15年API工具，现在经营一家叫Axiom的创业公司。

但文档变便宜之后，真正昂贵的东西浮现了：你怎么把一次性的API探索变成可重复的验证？怎么测试真实的工作流而不是一堆断开的请求？怎么从本地调试无缝切到CI环境而不重写所有东西？

他打了个比方：以前API文档像一堵高墙，挡住了后面的烂摊子。AI把墙拆了，大家才发现后面还是工地。

Postman的集合（Collection）功能试图解决这个问题。你可以保存请求、加测试脚本、分享给团队。但作者认为这属于"用更好的马鞭造汽车"——本质还是请求发送器的变种，没有触及工作流本身。

「行业花了多年打磨同一套请求发送模型的变体，然后称之为进步。」

工具碎片化：每个环节都在孤岛作业

作者列了一个典型API开发者的日常工具链：

探索阶段用Postman或Insomnia；文档写在Notion或Confluence；测试用Jest、Pytest或专门的API测试框架；CI/CD里再配一套不同的配置；监控又是另一套系统，Datadog或Grafana。

知识在各个环节断裂。一个工程师本地调试通过的请求，到了CI环境可能因为环境变量不同而失败。排查时需要重新走一遍整个链条。

「工作流决定了知识是累积还是死亡。」这是作者的核心判断。

他举了一个具体场景：你发现某个API端点的行为与文档不符，花了20分钟摸清规律。这个知识存在哪？Postman集合里？Slack对话里？还是只在你脑子里？

三个月后另一个工程师遇到同样问题，大概率要重新踩一遍坑。这就是知识死亡。

AI带来的新陷阱：生成即丢弃

现在的AI编程助手能瞬间生成调用API的代码。Copilot、Cursor、Claude Code都在做这个。

但作者警告这是一种"生成即丢弃"模式：AI帮你写出能跑的代码，你复制粘贴，它工作，你继续下一项任务。没有验证，没有持久化，没有变成团队资产。

「AI是在真正的验证循环中提供帮助，还是只是在生成更多一次性代码？」

他观察到一个现象：很多团队现在有两种API工作流。一种是"AI辅助的探索"——快速、混乱、一次性；另一种是"传统的手动验证"——慢、可靠、但没人愿意做。两者之间没有桥梁。

这解释了为什么API工具市场看起来热闹，实际体验却停滞。我们不是在解决workflow问题，而是在用新工具重复旧模式。

设计优先（Design-first）为什么没能改变游戏

OpenAPI推动的设计优先方法论曾被寄予厚望：先写规范，再生成代码和文档，从源头保证一致性。

作者承认这是" genuinely strong idea（真正扎实的想法）"，但现实中大多数团队做不到。规范写作本身就需要纪律，而业务压力总是优先于规范维护。

更现实的路径可能是"代码优先但可观测"：从实现出发，但确保行为能被自动捕获、测试、文档化。这和设计优先不是对立，而是承认大多数团队的实际起点。

他提到一个细节：很多团队的OpenAPI spec是生成的，不是手写的。生成工具的质量参差不齐，导致spec和实际行为仍有偏差。AI能帮你读spec，但读的是那个有偏差的版本。

那么，什么才算真正的进步

作者没有给出现成的答案，但划出了边界：

真正的API工具应该让探索、验证、持久化、共享形成闭环。不是四个独立的步骤，而是一个连续的动作。本地调试通过的测试，应该能无修改地运行在CI里。一次性的AI生成代码，应该能被捕获为可维护的测试用例。

他自己在做的Axiom方向是这个：把API测试做成"可执行的文档"，既能给人读，也能给机器跑，还能被AI理解和操作。

但这只是众多可能路径之一。更关键的问题是：为什么整个行业花了十年，还在原地打转？

作者的解释带点冷幽默：「我们习惯了摩擦。摩擦变成背景噪音，我们就以为问题解决了。」

Postman在2021年估值56亿美元，2023年裁员15%。Swagger被SmartBear收购后创新放缓。这些商业故事和工具停滞之间，或许有某种关联。

最后一个数据：在Stack Overflow 2024调查中，"API集成"仍然是开发者最头疼的十大问题之一，排名比三年前还上升了一位。

如果AI真的让API工作变简单了，为什么我们还这么痛苦？