文档
分类
标签
主要看这篇文章就行了 Swagger从入门到精通 虽然可能有些地方可能有老了,没讲到不过还是很实用,而且非常细致.
剩下的看编辑器事例就好了,一下子就能看懂了 官方在线编辑器
记录点一:
当请求操作时,有两种方式一种是路径请求,另一种是参数请求.两种表现形式不同.
参数请求
12345678910
// get(请求方式) /persons?pageSize=20&pageNumber=2 parameters: - name: pageSize in: query //就是这里,这里query表示参数请求 description: Number of persons returned type: integer - name: pageNumber in: query description: Page number type: integer
路径请求
1234567
// get(请求方式) /persons/{username} parameters: - name: username in: path //这里path表示路径请求 required: true //这个表示路径参数必须填写,默认为false表示这个路径是可选填的 description: The person's username type: string
9 / 54