后端开发每天在用的五个API工具——从调试到文档一条龙

做后端这些年，API工具换了不止一茬。从最早的Postman付费被恶心到，到后来试过Insomnia、Hoppscotch、Bruno，最后固定了一套组合。分享一下目前觉得最好用的五个。

1. Bruno — API调试首选，完全离线开源

网址：usebruno.com

Postman在2023年强制要求登录才能用本地功能后，我彻底放弃了它。Bruno是一个开源替代，最大特点：数据存在本地纯文本文件里（Bru格式），可以直接用Git版本控制。不需要注册账号、不上传任何数据到云端。

界面跟Postman差不多，支持环境变量、前置脚本、断言测试。GraphQL也支持。我用了一年多，日常90%的需求都能覆盖。缺的10%是WebSocket调试——这个用下面的工具补。

2. Hoppscotch — WebSocket和实时API调试

网址：hoppscotch.io

基于浏览器的API工具，轻到令人发指。打开网页就能用，不需要安装。它的杀手功能是WebSocket、SSE（Server-Sent Events）、Socket.IO、MQTT——这些实时协议Bruno和Postman都支持得不好。

可以自部署（Docker一键），数据本地存储。免费版完全够用，付费版多了团队协作。我平时Bruno做日常HTTP调试，碰到WebSocket就切Hoppscotch。

3. httpie — 命令行API调试，比curl友好十倍

如果习惯在终端里工作，curl语法记不住很正常。httpie是一个Python写的命令行HTTP客户端，语法直观：

http GET api.example.com/users
http POST api.example.com/login username=admin password=123

输出自动高亮、格式化JSON，比curl -s | jq少打很多字。支持HTTPS、认证、文件上传、session。npm和pip都能装。

4. Mockoon — 本地Mock API服务

前端等着后端接口写完才能联调的痛苦，做开发的人都懂。Mockoon是一个图形化的Mock API工具，点几下就能搭一个假的后端：定义路由、设置响应数据、模拟延迟和错误。数据存在JSON文件里，可以Git管理。

它比json-server强的地方：图形界面、支持Faker.js动态生成假数据（随机名字、邮箱、日期）、可以模拟不同HTTP状态码。我们团队开发新功能的时候，后端和前端并行——后端定义好API规范，前端拿Mockoon的数据先把UI跑通。

5. Scalar — API文档生成，Restructured的后继者

Swagger UI太丑了，这是行业共识。Scalar（scalar.com）是一个现代化的API文档生成器，支持OpenAPI 3.x，界面漂亮得多，支持暗色模式，交互式请求测试直接在文档页里跑。

免费版支持从OpenAPI规范生成文档，付费版多了团队协作和分析。我们在GitHub README里嵌了一个Scalar生成的文档页，客户可以直接在浏览器里试API，不用先装Postman。

这五个工具全部免费（或有免费版）就能满足日常开发需求。Bruno+Mockoon覆盖本地开发，Hoppscotch补实时协议，httpie提命令行效率，Scalar负责对外文档。一套下来比你用一个全家桶灵活得多。

标签： API工具 后端开发 开发工具 开源工具