openapi - OpenAPI 模式名称中可以包含“/”吗?
问题描述
我正在使用一个 API,它使用“foo/bar”之类的字符串来识别(区分)JSON 对象。
一个$ref
赞$ref: '#/components/schemas/foo/bar'
给了我错误。
是否支持此命名?我想利用 API 提供的这些属性来使用区分来选择最合适的组件模式。
我正在使用 OpenAPI 3.0.1。
解决方案
不。
OpenAPI 3.0 组件名称(包括架构名称)只能包含以下字符:
a-z A-Z 0-9 - . _
(来源)
但是,模式中的属性名称
没有限制,因此/
可以在属性名称中使用:
components:
schemas:
MySchema:
type: object
properties:
foo/bar: # <-----
type: string
推荐阅读
- javascript - 如何使用 yup 和 formik 验证表单?
- javascript - 从字符串创建类/组件
- python - Visual Studio Code - MS python intellisense - 缩进/换行
- c# - c# 遍历通过会话传递的字典
- python - 就最低计算复杂度而言,如何创建一个新的 pandas 列,该列基于另一列增加一定数量
- variable-assignment - 匈牙利算法:确定覆盖全零的最小行数
- c - 成功插入后在二叉树中“丢失”我的根地址
- spring-boot - 运行 Spring Batch 作业的最佳方法
- android - EXPO 接收通知在应用程序处于后台/前台时有效,但在应用程序被终止时无效
- python - 如何制作带有循环行的数据框?熊猫