摘要: 4.1私人定制(根据数据的type来对数据进行限制) 4.1.1字符串长度和格式 当定义一个字符串属性时,我们可以定制它的长度和格式 eg username: type:string pattern:"[a-z0-9]{8,64}" #用正则表达式定义字符串的格式 minLength:8 #字符串最 阅读全文
posted @ 2019-03-15 13:50 kgcqw 阅读(1351) 评论(0) 推荐(0) 编辑
摘要: 3.1简化数据模型 通过可重用定义来重构出现有重复定义的文档 eg.当在文档中多次出现关于person的定义时 阅读全文
posted @ 2019-03-15 11:39 kgcqw 阅读(2961) 评论(0) 推荐(0) 编辑
摘要: 2.1从一个最简单的API文档开始 #声明OPENAPI规范的版本 swagger:"2.0" #声明API相关信息,如版本信息、描述信息 info: version:1.0.0 title:Simple API description:A simple API to learn how to wr 阅读全文
posted @ 2019-03-15 10:24 kgcqw 阅读(240) 评论(0) 推荐(0) 编辑
摘要: 1.1 Swagger swagger是干啥的? 简单但功能强大的api表达工具 1.2OpenAPI规范 是REST API的API描述格式。OpenAPI 规范帮助我们描述一个API的基本信息,比如: 有关该API的一般性描述(Info) 可用路径(/资源) (path) 在每个路径上的可用操作 阅读全文
posted @ 2019-03-15 08:36 kgcqw 阅读(298) 评论(0) 推荐(0) 编辑