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

 


免责声明!

本站转载的文章为个人学习借鉴使用,本站对版权不负任何法律责任。如果侵犯了您的隐私权益,请联系本站邮箱yoyou2525@163.com删除。



 
粤ICP备18138465号  © 2018-2025 CODEPRJ.COM