在openAPI注释中大摇大摆地发布“Authorization:Bearer＜token＞”
我使用这些软件包（通过作曲家安装）
在def控制器中，我有以下注释：
/**
* @OA\Info(title="My API", version="0.1")
* @OA\Schemes(format="http")
* @OA\SecurityScheme(
* securityScheme="bearerAuth",
* in="header",
* name="Authorization",
* type="http",
* scheme="Bearer",
* bearerFormat="JWT",
* ),
* @OA\Tag(
* name="Auth",
* description="Auth endpoints",
* )
* @OA\Tag(
* name="Users",
* description="Users endpoints",
* )
*/
class Controller extends BaseController
/**
*
* @OA\Get(
* path="/users",
* operationId="getListOfUsers",
* tags={"Users"},
* description="Get list of users",
* security={{"bearerAuth":{}}},
* @OA\Parameter(
* name="Authorization",
* in="header",
* required=true,
* description="Bearer {access-token}",
* @OA\Schema(
* type="bearerAuth"
* )
* ),
* @OA\Response(
* response=200,
* description="Get list of users.",
* @OA\JsonContent(type="object",
* @OA\Property(property="message", type="string"),
* @OA\Property(property="data", type="array",
* @OA\Items(type="object",
* @OA\Property(property="id", type="integer"),
* @OA\Property(property="name", type="string"),
* @OA\Property(property="email", type="string"),
* ),
* ),
* ),
* ),
* @OA\Response(response=401, description="Unauthorized"),
* @OA\Response(response=404, description="Not Found"),
* )
*
* @return JsonResponse
*/
public function users()
因此，当我尝试通过swagger ui测试此路由时，我遇到了错误
当我检查标题（火狐）时，我没有看到
授权:不记名{ {访问令牌}}
但是我有我的代币
Cookie： XSRF-TOKEN=eyJpdiI6Ik5COUV5Y1ltRTM4eXNsRlpLY2ptTGc9PSIsInZhbHVlIjoiNDFCbG95c1RHSHRFT0IyWWZ4aWFRRQVJ6RHhTS1A4SFJiQXp2amlQc3RCUFRUWWs5R3RQQ0ZlakdFNnlvRm50MSIsIm1hYyI6ImM...
Swagger UI不能正确发送标题。注释有什么错？谢谢
共有1个答案
删除这些行:
* @OA\Parameter(
* name="Authorization",
* in="header",
* required=true,
* description="Bearer {access-token}",
* @OA\Schema(
* type="bearerAuth"
* )
* ),
并将其更改为：
* @OA\SecurityScheme(
* securityScheme="bearerAuth",
* in="header",
* name="Authorization",
* type="http",
* scheme="Bearer",
* bearerFormat="JWT",
* ),
到
* @OA\SecurityScheme(
* securityScheme="bearerAuth",
* in="header",
* name="bearerAuth",
* type="http",
* scheme="bearer",
* bearerFormat="JWT",
* ),
-
我正在使用Spring Boot2开发一个REST api。我在build.gradle文件中为Swagger2和Swagger-UI添加了SpringFox依赖项，如下所示： 不幸的是，像@enableswagger2这样的大摇大摆的注释似乎没有被识别出来。我该怎么办？
-
我们在我们的泽西应用程序中使用了@Role允许注释来限制用户对应用编程接口某些部分的访问。我们如何在SwaggerUI中显示这些信息？ 到目前为止，我已经用@ApiOperation注释了方法以显示in/out参数，并尝试使用@Authorization/@AuthorizationScope，但我只为我们不使用的oauth2显示了它。最接近out case的是ApiKeyAuthDefiniti
-
我想大摇大摆地发布一个json正文，就像这样: 目前，我有这样的定义： 但是数据是在URL中发送的。这里是Swagger提供的生成的curl： 我知道＜code＞查询＜/code＞关键字不好，但我没有找到POST JSON正文的方法。我尝试了＜code＞formData＜/code＞，但没有成功。
-
我有一个java项目（tomcat webapp）和一些REST Api。我想为他们生成大摇大摆的文档。我从本教程（github）开始。我没有maven我们使用蚂蚁任务。我加入了swagger-annotations-1.5.0。jar和所有随swagger jaxrs jar 1.5.0版本附带的jar（如果有用的话，我可以包括一个完整的列表），我已经注释了一些方法，我有一个如下的配置类： }
-
我正在使用Swagger创建一个文档页面，我想自动添加从正确的调用中收到的访问令牌。我试着用它 接收和存储令牌，以及 但是，要通过标头将其传递到后续请求，这只适用于一次调用，之后令牌将恢复为＜code＞null＜/code＞。 如何防止值被还原？
-
有没有人用spring-data-rest配置了swagger。我知道swagger有DocumentationConfig类，它扫描所有spring-mvc请求映射。但是,如何将其用于spring-data-rest,因为没有定义显式的请求映射。非常感谢在这方面的任何帮助。此外，我还想知道，是否有其他支持Spring-Data-REST的文档框架。