Swagger 响应中的变量键/对象名建模

Swagger 响应中的变量键/对象名建模,swagger,Swagger,我正在记录的REST方法的JSON响应包含一个名称为variable的对象。例如,下面的“流程”对象可能包含“应用程序”或“服务”对象,具体取决于所查询的流程类型: // Response may contain: "processes": { "app": { ... } } // Or this: "processes": { "service": { ... } } 在键名不固定的情况下,建议采用什么方法对这种类型的场景进

我正在记录的REST方法的JSON响应包含一个名称为variable的对象。例如,下面的“流程”对象可能包含“应用程序”或“服务”对象,具体取决于所查询的流程类型:

// Response may contain:
"processes": {
    "app": {
        ...
    }
}

// Or this:
"processes": {
    "service": {
        ...
    }
}

在键名不固定的情况下,建议采用什么方法对这种类型的场景进行建模?我查看了
enum
,但它似乎是用于枚举可能的键值,而不是键名

需要更多信息。“应用”和“服务”的结构是什么。“流程”下是否有一个额外的字段来说明响应的类型?不幸的是,“应用程序”和“服务”的结构是相同的,并且“流程”下没有其他字段。那么描述它的唯一方法就是说两者都存在,是的,这意味着理论上两者都可以提供。谢谢,这非常有用。与此相关的是,那些不能提前知道的关键名称呢?例如,一个响应包含一个对象列表,这些对象的键名是自动生成的UUID?您可以使用
additionalProperties
定义一个通用键(map),但无法控制类型。将来,我们还可能支持
patternedProperties
,这将为您提供更多限制密钥的灵活性。