OpenAPI 3.0.1无OAuth1支持，如何标记接口需OAuth1认证？

针对你遇到的OpenAPI 3.0.1不支持OAuth1、但需要标记并可视化展示受保护端点的需求，我整理了几个简单实用的方案，都不需要改动规范核心或实现完整认证逻辑：

1. 利用OpenAPI自定义扩展字段（x-*） #

这是最贴合OpenAPI规范的方式，官方明确允许使用x-前缀的自定义字段来添加额外元数据。你可以给需要OAuth1认证的端点操作添加专属标记，比如x-auth-type: oauth1。

示例代码片段：

paths:
  /api/user/info:
    get:
      summary: 获取用户敏感信息
      x-auth-type: oauth1  # 自定义标记字段
      responses:
        '200':
          description: 成功返回用户信息

在可视化工具（比如Swagger UI）中，你可以通过自定义逻辑识别这个字段，给对应接口加上醒目的视觉标记——比如一个🔒图标，或者“OAuth1保护”的红色标签，让用户一眼就能区分受保护的接口。

2. 通过Tags分组标记 #

如果你的接口数量不多，可以给所有需要OAuth1认证的端点统一添加一个专属标签，比如"OAuth1 Protected"。

示例代码片段：

paths:
  /api/order/submit:
    post:
      summary: 提交订单
      tags: ["业务接口", "OAuth1 Protected"]  # 加入专属标签
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                orderId:
                  type: string

在Swagger UI这类工具中，标签会作为分组维度展示，用户既可以通过标签快速筛选出所有受OAuth1保护的接口，也能在单个接口的信息里看到这个标记，直观判断是否需要特殊认证。

3. 自定义Security Scheme占位 #

虽然OpenAPI 3.0.1没有官方的OAuth1类型，但你可以在components/securitySchemes里定义一个占位的自定义认证方案，然后绑定到需要保护的端点上。

示例代码片段：

components:
  securitySchemes:
    OAuth1Auth:
      type: http
      description: 此接口需要通过OAuth1协议进行认证
paths:
  /api/payment/process:
    post:
      summary: 处理支付请求
      security:
        - OAuth1Auth: []  # 绑定自定义认证方案
      responses:
        '200':
          description: 支付处理成功

这种方式的好处是，可视化工具会默认显示该接口需要认证，鼠标hover时还能看到你添加的描述，明确告知用户是OAuth1认证，无需额外开发太多自定义逻辑。

以上三个方案都能满足你“仅可视化展示接口是否受保护”的需求，选择哪个取决于你的具体场景——如果需要更灵活的元数据，选自定义扩展字段；如果侧重分组筛选，用Tags；如果想利用工具自带的认证标记逻辑，就用自定义Security Scheme。

内容的提问来源于stack exchange，提问作者zghib