スワッガースキーマのoneOfが機能しない

Question

PaymentMethodを次のように定義します。 oneOfはswagger.yamlでサポートされていますか？

PaymentMethod: 
     oneOf: 
     - $ref: '#/definitions/NewPaymentMethod' 
     - $ref: '#/definitions/ExistPaymentMethod' 

ExistPaymentMethodは単にIDを有することになる

、及びcardNumberNewPaymentMethod無idを持たないであろうが、すべての他の詳細、例えばcardNumber、cardholderName、cardholderAddressなど

Answer 1

SwaggerはJSONスキーマのみからインスピレーションを得ています。 JSONスキーマから大きく外れたわけではありませんが、いくつかのことを残したり、いくつか追加したり、いくつかの動作を変更したりします。スワッガーが去るものの1つはoneOfです。

詳細は、バージョン2

githubの発行refを闊歩ないOpenAPIのバージョン3でサポートされてhttp://swagger.io/specification/#schemaObject

Answer 2

oneOfので見つけることができます：変更のリストについては、https://github.com/OAI/OpenAPI-Specification/issues/333

は、以下を参照してくださいhttps://blog.readme.io/an-example-filled-guide-to-swagger-3-2/