Swagger 中是否有任何 "escape"

Question

我有一个 REST API，其中提交给端点的合法 JSON 将包含一个子树，具体取决于顶层的 "type" 声明。类似于：

{
   ...
   "mtype": "http:...",
   "content": {
      .. what goes here is what would be defined by the above "mtype"

本质上，'mtype' 是 'content' 内容的架构 url。但我正在寻找的是 <xsd:any>.

的等价物

如果我可以在其中放置一些内容，指示 Swagger UI 只需在其中放置一个大文本框，供用户粘贴 JSON 正文，这就已经很有用了。

Answer 1

您可以 return 没有属性的 object 类型的对象作为响应。这不是最佳做法，但可以满足您的目的

Answer 2

我不太了解 Swagger，但我知道它的类型定义是基于 JSON 架构的。在 JSON 模式中，<xsd:any> 等价于 {}。对于任何有效的 JSON，空模式验证为 true。我希望这在 Swagger 中应该没有什么不同。