swagger3 增加登录验证

Swagger 3（也称为 OpenAPI Specification 3）是一个规范化的工具，用于生成、描述和文档化RESTful API。要在 Swagger 3 中增加登录验证，你需要遵循以下几个步骤：

1. **设置基本认证**:
- 在`openapi.yaml` 或 `openapi.json` 文件中，在`paths`部分定义你的API资源，添加一个包含`x-auth`属性的操作（如`/login`）。例如：

     /login:
       x-auth:
         type: basic

- 这将告诉 Swagger 使用HTTP基本认证。

2. **定义请求示例**:
- 添加一个请求示例（通常作为`requestBody`），展示如何发送登录信息，如包含用户名和密码的数据结构。

3. **自定义验证规则**:
- 使用`securitySchemes`配置安全策略，可以创建一个JWT令牌验证或OAuth2等，然后在需要保护的路径上引用它：

     securitySchemes:
       api_key:
         type: apiKey
         name: Authorization
         in: header
     paths:
       '/private-endpoint':
         get:
           security:
             - api_key: []

4. **处理响应和错误**:
- 对于成功的登录，返回一个包含访问令牌的响应。对于失败的情况，比如无效的凭证，返回适当的错误状态码和消息。

5. **客户端实现**:
- 开发者在使用 Swagger UI 浏览API文档时，会被提示输入用户名和密码，登录成功后才能访问受保护的路径。