我仍然会在需要探索API、查看响应或快速拼一个请求时使用图形化API客户端。

它们很方便。

打开网易新闻 查看精彩图片

但我使用API的方式已经变了。

现在我的开发工作流有更多部分发生在终端里。测试在终端跑,Git命令在终端跑,CI/CD在终端跑,越来越多的AI编程助手也在终端里干活。

这给那些假设图形界面永远是工作流中心的API工具制造了一个问题。

如果一个AI编程助手正在处理一个后端功能,我不一定希望它停下来、打开一个图形应用、点开一个集合、手动跑一遍API测试。

希望API工具能在其余工作发生的同一个环境里被访问。

这就是我越来越关注能在终端里工作的AI原生Postman替代方案的原因。

但重要的区分在于,“终端API客户端”可能指的是完全不同的东西。

像curl这样的工具,擅长发送单个请求。

终端REST客户端能让交互式探索API更方便。

但一个开发团队需要的可能远不止发送HTTP请求。

他们可能需要可复用的测试场景、环境、断言、报告、API schema、文档、CI/CD集成,以及越来越重要的——一个AI助手真正能操作的CLI。

这就是我在这里想探讨的类别。

什么让一个API工具是AI原生的?

我不认为给一个API客户端加上“AI”这个词就自动让它变成AI原生。

对我来说,一个对AI友好的API工具需要能配合助手实际的工作方式。

一个助手需要能够:

- 从终端运行命令

- 理解结构化输出

- 执行可重复的测试

- 处理API规范和schema

- 读取和修改API资源

- 处理环境和变量

- 以编程方式检测失败

- 在做出改动后验证结果

- 自然融入CI/CD

- 不依赖图形界面

这跟仅仅在一个API客户端里塞一个AI助手是不同的要求。

终端本身成了接口的一部分。

而这一点之所以重要,是因为AI编程助手本来就把大量时间花在终端里。

为什么有了AI助手后终端更重要

设想一个典型的开发工作流。

我让一个AI编程助手新增一个接口。

这个助手需要:

- 理解现有API结构

- 实现接口

- 更新API契约

- 跑测试

- 检查失败

- 修复实现

- 再跑测试

- 确认最终结果

如果API测试完全活在图形界面里,这个工作流就会断裂。

助手能写代码,但接下来得由人来接手,手动完成API测试。

这本身不算坏事。

但它制造了一次上下文切换。

命令行API工具改变了这一点。

助手可以直接调用API工具、检查输出、做出修正、再跑一次测试。

这就是终端优先的API工具变得更有意思的地方。

1. Apidog CLI

Apidog CLI有意思的地方在于,它不是简单地用命令行替代发HTTP请求。

它把API开发工作流中更大的一部分搬进了终端。

这个CLI可以运行API测试场景,处理API资源和schema,管理环境和变量,导入导出API数据,并集成CI/CD工作流。它的命令面超出了单纯发送单个HTTP请求。

它有什么不同

重要的一点是,这个CLI不要求你把已有的API测试重写成shell脚本。

你可以在Apidog里创建测试场景,然后从命令行无头执行这些场景。

比如:

apidog run -t -e -r cli

这个CLI还能产出CLI、HTML、JSON和JUnit格式的报告,这让它在本地和自动化流水线里都有用。

这带来一种工作流:可视化界面负责编写和调试,终端负责可重复的执行。

AI的角度在哪里

这在配合编程助手时变得特别有用。

助手不需要理解怎么在一个API测试应用里点来点去。

它可以调用CLI命令、检查结构化结果,再用这些结果决定下一步做什么。

Apidog还专门记录了配合AI助手使用CLI的工作流,包括验证结构化改动、通过CLI应用改动、读回资源、通过助手运行API测试。

这让CLI不只是一个CI工具。

它可以成为助手开发工具箱的一部分。

一个实际的例子

设想一个助手被要求新增一个 /users/preferences 接口。

它修改后端代码。

然后它可以从终端运行一个已有的API测试场景。

如果断言失败,助手可以检查结果、定位问题、修改实现、再跑一遍场景。

整个反馈循环不用离开开发环境。

这就是我谈到AI原生API工具时所指的那种工作流。

2. Bruno

Bruno在终端API工作流上走的是另一条路。

它不围绕云端工作区,而是围绕本地、对Git友好的API集合来设计。

这让它对那些希望API请求和测试与应用代码放在一起的开发者来说很有意思。

它有什么不同

基本思路很直接:

你的API集合可以作为文件放在你的代码仓库里。

这意味着开发者能用Git做版本管理,通过pull request审查改动,让API相关的工作贴近应用代码。

命令行工作流于是成为这种思路的自然延伸。

AI的角度在哪里

这种模式对编程助手尤其顺手,因为助手本来就习惯处理仓库里的文件。

一个助手可以检查API集合、做出改动、运行相关命令、提交结果。

对私有工作区的依赖更少。