OpenAPI

【背景】 3 年测试开发，维护一条 B 端 SaaS 的订单 + 支付链路（Java 17 + Spring Boot 3 + JUnit 5，接口自动化 pytest + httpx 约 900 条用例，共享 staging）。团队已按社

背景 做了 3 年中间件研发，期间给 4 个团队搭过 API 网关、写过服务间调用 SDK。每次 onboarding 新同学，我都会问一句：「咱们的 OpenAPI spec 文件在哪？最近一次更新是什么时候？」 答案通常是： - 「在

背景 做了 8 年技术文档，这两年帮 4 个后端团队做过文档体检。一个反复出现的现象让我想拿出来聊：同一个团队，对外 API 的「文档质量」差距可以大到让集成方怀疑是不是不同公司发的 SDK。 我复盘过的典型事故，根因都不是「没写文档」，而