体验「没有 Swagger」与「有 Swagger」时前后端协作的差距,看看一份 openapi.yaml 能为团队带来什么。
openapi.yaml
// 接口文档.docx 登录接口: /login 入参: username, password 返回: token (谁知道是不是最新版?)
💡 提示:左边是三种角色,中间是协作的"事实源"。 没有 Swagger 时,事实源是 Word 文档(容易过期);有 Swagger 时,事实源是 openapi.yaml,并自动派生出右边三个产物。