常用字段说明
schemes | 使用协议（如：http、https） |
host | 项目地址，这个地址会作为每个接口的url base，拼接起来一起作为防伪地址 |
consumes | 接口默认接收的MIME类型（如：formData） |
produces | 接口默认返回MIME类型。api接口用的比较多的是 application/json 和 application/xml |
summary | 接口的简要介绍，会显示在接口标头上，不能超过120个字符 |
description | 接口的详细介绍 |
externalDocs | 外部文档连接 |
operationId | 全局唯一的接口标识 |
parameters | 参数列表 |
@SWG\Info | 此项填写的内容会放在文档开头，用作文档说明 |
@SWG\TAG | tag是用来给文档分类的，name字段必须唯一，某个接口可以指定多个tag，那它就会出现在多组分类中（tag也可以不用在这里预先定义） |
@SWG\Get | 通过get的方式请求数据 |
@SWG\Post | 通过post的方式请求数据 |
@SWG\Parameter常用字段说明
name | 参数名 |
in | 参数的来源，必填，取值范围：query、header、path、formData、body |
description | 参数描述 |
type | 参数类型，取值范围：string、number、integer、boolean、array、file |
required | 参数是否必须，取值范围：true、false (通过路径传参in="path"时必须为true) |
default | 参数的默认值 |