#API 文档

OpenAPI 发布前检查清单：不只要 YAML 能打开

一份 OpenAPI 或 Swagger 文件能被编辑器打开，不代表接口契约可靠。本文梳理版本、路径参数、operationId、响应、Schema、外部引用和 CI 校验的实际检查顺序。