如何修复 Swagger 编辑器中的“路径参数...必须在 /path 中具有相应的 {...} 段”错误？

Question

我正在尝试为 Webcase Create 会议创建 OpenAPI 定义。这是我的 YAML 代码：

openapi: '3.0.0'
info:
  title: WebcastCreateMeeting
  version: "1.1"
servers:
  - url: https://api.webcasts.com/api
paths:
  '/event/create':
    post:
      tags:
       - CreateMeetingCallbody
      summary: EventGM
      parameters:  
        - in: path
          name: event_title                        # >> line 15
          description: name of the event from Cvent
          required: true
          schema:
            type: string
      responses:
        200:
          description: This would be the response.
          content:
            application/json;charset=utf-8:
              schema:
                type: array
                items:
                  properties:
                    scheduled_duration:
                      type: integer
                      example: 30
                    event_id:
                      type: integer
                      example: 0000000
                    event_title:
                     type: string
                     example: Cvent Testing sync event

我在 Swagger 编辑器中看到的错误是：

paths./event/create.post.parameters.0.name 处出现语义错误
路径参数“event_title”必须在“/event/create”路径中具有对应的 {event_title} 段
跳转到第 15 行

这个错误是什么意思以及如何修复它？

Answer 1

使用路径参数 ( in: path) 时，路径必须在大括号中包含参数名称{ }，以指示该参数插入路径中的确切位置。

paths:
  '/event/create/{event_title}':

有关详细信息，请参阅描述路径参数。