与BODY无效的Swagger POST请求

Question

我的POST请求未显示BODY字段。

我的招摇文档

Swagger docs petstore

我的方法是如此

 @ApiOperation(nickname = "insert",
              value = "Desc",
              httpMethod = "POST")
public Result insert()

我忘了什么？

谢谢！

Answer 1

我假设您正在使用游戏框架2.5的swagger-play集成。你不应该指定http方法，它应该能够从你的路径文件中找出它。

至于身体领域，招摇会做其中一个：

• 根据方法参数（使用@ApiParam）生成字段
• 使用implicit parameters（@ApiImplicitParams）
生成字段

通过insert（）方法的外观（它没有任何显式参数），您可能需要使用第二个注释。不要忘记使用适当的paramType（可能是身体）。