4.8.8.1 模式化字段

字段模式	类型	描述
/{path}	路径项对象	到单个端点的相对路径。字段名称必须以正斜杠 (/) 开头。路径附加（无相对 URL 解析）到Server 对象的 url 字段中扩展的 URL 以构建完整 URL。路径模板是允许的。在匹配 URL 时，将先匹配具体的（非模板化的）路径，然后再匹配其模板化的对应路径。具有相同层次结构但不同模板名称的模板化路径不得存在，因为它们是相同的。在出现歧义匹配的情况下，由工具决定使用哪一个。

此对象*可以使用 规范扩展 进行扩展。

4.8.8.2 路径模板匹配

假设以下路径，如果使用具体的定义 /pets/mine，则将首先匹配它

  /pets/{petId}
  /pets/mine

以下路径被认为是相同的且无效的

  /pets/{petId}
  /pets/{name}

以下可能导致歧义解析

  /{entity}/me
  /books/{id}

4.8.8.3 Paths 对象示例

{
  "/pets": {
    "get": {
      "description": "Returns all pets from the system that the user has access to",
      "responses": {
        "200": {         
          "description": "A list of pets.",
          "content": {
            "application/json": {
              "schema": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/pet"
                }
              }
            }
          }
        }
      }
    }
  }
}

/pets:
  get:
    description: Returns all pets from the system that the user has access to
    responses:
      '200':
        description: A list of pets.
        content:
          application/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/pet'