Swagger3文档瘦身

3.1简化数据模型

通过可重用定义来重构出现有重复定义的文档

eg.当在文档中多次出现关于person的定义时

            required:
              - username
            properties:
              firstName:
                type: string
              lastName:
                type: string
              username:
                type: string
将关于重复出现的person定义抽取出来
definitions: #添加定义项
Person:
            required:
              - username
            properties:
              firstName:
                type: string
              lastName:
                type: string
              username:
                type: string
需要用到这个定义时,用$ref属性来引用即可
$ref:"#/definition/Person" #引用一个定义来增加另一个定义

 
posted @ 2019-03-15 11:39  kgcqw  阅读(2997)  评论(0)    收藏  举报