openapi 2多种响应类型

时间:2017-11-30 11:51:08

标签: swagger swagger-2.0 openapi

我知道使用openapi 3我可以使用oneOf / anyOf但目前我们无法升级到openapi 3.在其中一个定义中,我需要使用许多没有共同属性的响应类型(基本上响应是没有任何方法/属性的接口,并且具有多个不同的实现)。我可以用openapi 2以某种方式定义多个响应类型吗?是否可以使用例如headers / content-types / ...来区分这些响应类型并具有有效的openapi2定义?

感谢

1 个答案:

答案 0 :(得分:0)

<强>更新

只要它们具有不同的HTTP状态代码作为&#34;密钥&#34;,就会有多个响应。 default关键字就是这样,API的用户应该期望如果HTTP状态不在响应列表中default应该使用。 (例如,如果有人使用switch来处理default地址default中的switch个案件的回复。

对于发送多种可能类型的响应的单个HTTP状态代码,不明确支持。一个丑陋的解决方法是创建包含所有字段的类型,并且由客户端根据哪些字段保存值进行区分。