swagger问题,么信息应该放在header,什么信息应该放在query里面?

这种情况下的注解,是不是重复了?况且,它里面的age,为什么要放在 paramType="path"里面呢?
哪到底是什么信息应该放在header,什么信息应该放在query里面? 没有找到相应的文档呢,只有说明query header等是放在哪里,没有具体的什么字段放在哪里的。。

img

  1. @ApiImplicitParam @ApiParam 重复,定义一个就可以了,个人建议使用 @ApiParam。
  2. paramType="path" 表示 age 是请求路径中的参数,与 Spring MVC 中的 @PathVariable 是对应的,这是 RESTFUL 风格的一种写法。
  3. 通常情况,只会将一些通用的参数放入请求头 header,如表示用户标识的 token,用户的设备信息,代理服务器添加的表示原始请求 IP 的请求头等等。
  4. 通常情况,query 信息只会存储 GET 请求方法的参数,如果换成 POST 方法,会将参数放在请求体中。

如果还有疑问,可以留言评论,有帮助的话麻烦给个采纳。

img


paramType的意思是你把请求参数是放在什么位置,或者换种说法,就是说,你后端是如何解析这个请求参数的。