swagger3.0统一添加token

### 回答1：
Swagger 3. 可以通过在请求头中添加 Authorization 字段来统一添加 token。具体操作步骤如下：

1. 在 Swagger UI 中找到需要添加 token 的接口，点击右侧的“Authorize”按钮。

2. 在弹出的窗口中输入 token，并选择 token 的类型（如 Bearer Token）。

3. 点击“Authorize”按钮，完成 token 的添加。

4. 在请求接口时，Swagger 会自动在请求头中添加 Authorization 字段，并将 token 值添加到其中。

需要注意的是，每次添加 token 后，Swagger UI 会将 token 保存在浏览器的本地存储中，下次访问接口时会自动加载上次保存的 token。如果需要更换 token，可以再次点击“Authorize”按钮，输入新的 token 并保存。

### 回答2：
Swagger3.0是目前市场上使用最为广泛的API文档工具和规范。使用Swagger可以帮助我们更加高效地管理和维护API文档，使得API的开发和调用变得更加方便。在实际的项目中，很多API需要使用token来进行身份验证，保障API的安全性。

为了统一添加token，我们需要在Swagger3.0配置文件中进行相应的设置。首先，我们需要在Swagger的全局配置中添加Authorization header，如下所示：

swagger: "3.0"
info:
  title: My API
  version: 1.0.0
  description: My API Description
servers:
  - url: http://localhost:8080
    description: Local Server
security:
  - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

在上述配置中，我们使用了OpenAPI 3.0的security配置，其中bearerAuth是自定义的名称，我们需要确保这个名称与下面的实际使用一致。在components里面我们定义了securitySchemes，使用JWT作为token传递方式。这样使用者就可以通过在请求header中添加Authorization属性来进行token认证了。

接下来，我们需要在API接口的具体定义中进行配置。例如，下面展示了一个获取用户信息的API：

paths:
  /users/{userId}:
    get:
      summary: Get user by ID
      parameters:
        - in: path
          name: userId
          required: true
          schema:
            type: integer
            format: int64
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserResponse'
      security:
        - bearerAuth: []

在这个示例API中，我们添加了security配置并指定了它所属的securitySchemes为bearerAuth。这样我们在访问该API时就必须携带token认证才能成功访问。

总之，通过上述配置我们可以在Swagger3.0中统一添加token，保障我们API的安全性。同时，我们也可以在Swagger的UI界面中方便的进行API测试和调试。在实际的API开发中，我们可以通过结合各种框架和工具，实现更加灵活的API管理和调用。

### 回答3：
Swagger3.0 是一种基于标准 OpenAPI 规范的 API 文档框架，可以快速地生成并描述 REST API 的接口文档，其可读性、可维护性和可测试性都比较高。而对于需要进行用户认证与授权的 API 接口来说，就需要采用一些安全机制以确保 API 请求的合法性。其中，token 就是一种常用的认证方式。

在 Swagger3.0 中统一添加 token 的方式可以通过以下几步实现：

1.在项目的 pom.xml 文件中添加依赖：

<dependency>
   <groupId>io.springfox</groupId>
   <artifactId>springfox-boot-starter</artifactId>
   <version>3.0.0</version>
</dependency>

2.在 Swagger3.0 的启动配置文件中添加以下代码：

@Configuration
@EnableSwagger2WebFlux
public class SwaggerConfig {
  @Bean
  public Docket api() {
      return new Docket(DocumentationType.SWAGGER_2)
              .select()
              .apis(RequestHandlerSelectors.any())
              .paths(PathSelectors.any())
              .build()
              .securitySchemes(Arrays.asList(apiKey()))
              .securityContexts(Arrays.asList(securityContext()));
  }

  private ApiKey apiKey() {
      return new ApiKey("token", "token", "header");
  }

  private SecurityContext securityContext() {
      return SecurityContext.builder()
              .securityReferences(Arrays.asList(new SecurityReference("token", new AuthorizationScope[]{})))
              .build();
  }

  @Bean
  public SecurityConfiguration security() {
      return SecurityConfigurationBuilder.builder()
              .clientId("test-app-client-id")
              .clientSecret("test-app-client-secret")
              .realm("test-app-realm")
              .appName("test-app")
              .scopeSeparator(",")
              .additionalQueryStringParams(null)
              .useBasicAuthenticationWithAccessCodeGrant(false)
              .build();
  }
}

其中，ApiKey 主要定义了 token 的名称、位置和类型；SecurityContext 主要定义了针对哪些路径使用 token 认证；SecurityConfiguration 定义了客户端的相关信息和授权方式。

3.在 API 接口中添加 @ApiOperation(value = "xxx", authorizations = {@Authorization(value="token")}) 注解，如：

@ApiOperation(value = "get user info", authorizations = {@Authorization(value="token")})
@GetMapping("/user/info")
public String getUserInfo(HttpServletRequest request) {
    // 此处添加验证逻辑
  return "user info";
}

经过以上配置，Swagger3.0 就会要求在请求头中添加名为 token 的参数，并进行认证，才能访问包含 @ApiOperation(value = "xxx", authorizations = {@Authorization(value="token")}) 注解的 API 接口。这样可以提高 API 接口的安全性，阻止未授权的访问，从而保护用户的数据安全。