档案库 · 开发与企业工具 · 产品决策 · 2023–2026
OpenAPI DevTools 押注：规范应来自流量，而非文档；Show HN 获811分
Andrew Walsh 的 Chrome/Firefox 扩展将实时网络请求转化为 OpenAPI 3.1 规范；2023年10月25日的 Show HN 获811分，GitHub 星标4.3k
OpenAPI DevTools (Andrew Walsh)
做的是什么生意
OpenAPI DevTools is a browser extension that adds an OpenAPI tab to browser DevTools and generates OpenAPI 3.1 specifications in real time from the network requests a site actually makes — automatically merging headers, bodies and query parameters per endpoint, recognizing path parameters, previewing the spec with Redoc, and letting users export, import or share sessions.
起因
Andrew Walsh built the extension around the gap between standards and reality: OpenAPI is the modern standard for REST APIs, governed by the OpenAPI Initiative and the Linux Foundation, and systems that have specs are far easier to work with — yet discovering a site's API behaviour usually means depending on docs that may not exist. The tool records what actually happens: it converts the JSON requests that fire while a developer browses into a specification, and where an endpoint responds inconsistently (a value sometimes a string and sometimes null), the spec records both until more data arrives.
经过
The material shows the project expanding across surfaces: the repo's 'Important' note announces that a new and final version was rewritten from scratch, with automatic path-parameter identification, a desktop app using a proxy (e.g. mitm2swagger), a website and CLI that generate OpenAPI specifications from HAR files (e.g. har-to-openapi), a published library for middleware, DevOps integrations or any environment, curl and client-code generation plus an auto-populating API client, and the ability to translate into different OpenAPI versions or reverse-engineer other HTTP standards such as GraphQL. The extension itself shipped in the Chrome Web Store and Firefox Add-on Store.
结果
As of the 2026-09-04 crawl the original repository is live at 4.3k stars and 86 forks, with the README pointing development at Demystify, a from-scratch successor whose repository describes a desktop proxy app, browser extension, CLI and library. No company, funding or revenue is documented in the material.
背景
OpenAPI DevTools 是 Andrew Walsh 的浏览器扩展，它在 Chrome 和 Firefox 开发者工具中添加 OpenAPI 标签页，并将应用实际发出的网络请求转为 OpenAPI 3.1 规范。请求头、请求体和查询参数按端点自动合并，路径参数从重复请求中识别，规范在工具内用 Redoc 预览，会话可导出、导入或分享。
这个赌注是 API 文档应从观察流量而非手写生成：README 的口号是“轻松发现任何应用或网站的 API 行为”，该工具有意增加功能——每个匹配的未来请求都会合并到端点规范中，变化的值（字符串或 null）先记录两者，直到更多证据出现。
关注是即时的：2023年10月25日的 Show HN 获得811分和102条评论，GitHub 仓库在2026年9月4日抓取时星标4.3k，分叉86。到那时，README 宣布新最终版本已从头重写，指向 Demystify。
Demystify 将同一想法扩展到各个层面：自动路径参数识别、代理流量的桌面应用（类似 mitm2swagger）、从 HAR 文件生成规范的网站和 CLI（har-to-openapi 风格）、用于中间件和 DevOps 的已发布库、curl 和客户端代码生成，以及转换 OpenAPI 版本或逆向工程 GraphQL 等 HTTP 标准的能力。资料中未记录任何公司、融资或收入。
这件事要成立，得有什么
- 可验证的关注度：2023年10月25日的 Show HN 获811分和102条评论（项目编号 38012032），仓库在2026年9月4日抓取时星标4.3k，分叉86。
- 赌注具体：监控真实网络流量并合并观察结果到规范中，API 发现不再依赖缺失、错误或仅限内部使用的文档。
- 资料记录了后续：README 的“重要”公告宣布从头重写（Demystify），成为桌面应用、CLI、网站和库，而不只是扩展。
- 它诚实地说明范围：扩展合并观察到的内容并记录未知值（如可空），而非猜测，这一设计选择在 README 中说明。
可借鉴之处
当文档成为瓶颈时，从观察到的行为生成文档：真实流量不会像书面规范那样过时，产出可解锁下游的客户端、测试和集成。
后续进展
截至2026年9月5日，原始仓库仍在线，星标4.3k，分叉86，其 README 将用户引导到 Demystify（github.com/AndrewWalsh/demystify），一套实时或从 HAR 文件生成 OpenAPI 3.1 规范的工具集：桌面代理应用、浏览器扩展、CLI（npx demystify --input file.har）和 demystify-lib 库，外加 GraphQL 支持。资料中未记录公司、融资或收入，商业状况未经验证；已记录的是从一个2023年 Show HN 扩展演进到更广泛的 API 文档工具链。
资料来源
- Show HN: OpenAPI DevTools – Chrome extension that generates an API spec
- AndrewWalsh/openapi-devtools — README (4.3k stars at crawl)
发现哪里写错了？告诉我们。
轮到你了
你刚读完一家。说说你在做什么，看看谁在赌同一件事。
免费账号 · 3 次免费提问 · 不用绑卡