Question

我正在创建一个API的OpenAPI 3.0规范/描述，其中许多请求主体都包含一些相同的参数，而这些参数是原始数据类型，例如字符串或整数。例如：

imei:
  type: integer
  format: int64
  description: 4G hardware device identifier

我想只在“ components”对象中定义一次这些参数，然后使用$ ref在需要的地方包括它们，而不是在许多不同的请求正文中定义相同的参数。我还没有找到一种方法。

在“参数”对象中定义的参数不能在请求正文中使用。笨蛋我认为这在2.0中是允许的。
我可以在“方案”对象中定义这些参数，但是Swagger编辑器随后将它们显示在“模型”下。将作为原始数据类型的参数称为模型有点麻烦。这些是模型中使用的参数，而不是模型本身。

我已经广泛搜索了SO和网络，却没有找到解决这个特定问题的方法。也许答案是“无法完成”，但这似乎是OpenAPI技术委员会的疏忽。