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" #引用一个定义来增加另一个定义

 

猜你喜欢

转载自www.cnblogs.com/itmeatball/p/10536023.html