OpenAPI 模式名称中可以包含“/”吗？答案

【问题标题】：Can OpenAPI schema names have "/" in them?OpenAPI 模式名称中可以包含“/”吗？
【发布时间】：2019-07-17 15:28:28
【问题描述】：

我正在使用一个 API，它使用“foo/bar”之类的字符串来识别（区分）JSON 对象。

$ref 之类的 $ref: '#/components/schemas/foo/bar' 给了我错误。

是否支持此命名？我想利用 API 提供的这些属性来使用区分来选择最合适的组件架构。

我使用的是 OpenAPI 3.0.1。

【问题讨论】：

标签： openapi

【解决方案1】：

没有。

OpenAPI 3.0 组件名称（包括架构名称）只能包含以下字符：

a-z A-Z 0-9 - . _

但是，模式中的属性名没有限制，所以/可以用在属性名中：

components:
  schemas:
    MySchema:
      type: object
      properties:
        foo/bar:   # <-----
          type: string

【讨论】：