自定义组件对象-OpenAPI

Question

是否可以在OpenAPI中为组件对象指定自定义名称？

我目前有两个组件对象指定请求模式：

Request1:
type: object
description: Request 1
properties:
  a:
    description: Filter 1 a
    $ref: '#/definitions/Filter1a'
  b:
    description: Filter 1 b.
    $ref: '#/definitions/Filter1b'
 


Request2:
    type: object
    description: Request 2
    properties:
      query:
        type: object
        description: Filter 2.
        properties:
            bool:
              type: object
              properties:
                  must:
                    type: array
                    items:
                      type: object
                      properties:
                        match_all:
                          type: object

在endpoint描述中，我将这些模式引用如下：

/v2/myEndpoint: 
    post: 
      tags: 
        - some tags
      operationId: someId
      summary: Some summary
      description: Some description 
      produces:
        - application/json
      parameters: 
        - in: body
          name: body
          required: false
          schema:
            oneOf:
              - $ref: '#/definitions/Request1'
              - $ref: '#/definitions/Request2'

当我发布yaml文件时，UI在选择选项卡中显示Request est1和Request est2，其中包含名称“Request est1”和“Request est2”。是否可以为它们分配自定义名称，以便UI显示自定义名称？例如“自定义名称请求1”和“自定义名称请求2”？

非常感谢！

Answer 1

我猜你指的是大摇大摆的用户界面。

title会这样做。链接到Open Api Spec。

Request1:
 title: Custom name request 1
 type:...

Request2:
 title: Custom name request 2
 type:...