oneOf in Swagger schema does not work

by

oneOf is supported in OpenAPI version 3 (openapi: 3.0.0), but not in Swagger version 2 (swagger: '2.0').

PaymentMethod:
  oneOf:
    - $ref: '#/components/schemas/NewPaymentMethod'
    - $ref: '#/components/schemas/ExistPaymentMethod'

GitHub issue ref: https://github.com/OAI/OpenAPI-Specification/issues/333

For a list of changes in OpenAPI 3.0 compared to 2.0, see: https://blog.readme.io/an-example-filled-guide-to-swagger-3-2/

More Related Contents:

  1. How to add multiple example values in swagger properties?
  2. How to add multiple example values for an array in OpenAPI/Swagger?
  3. Use placeholders in yaml
  4. How can I include a YAML file inside another?
  5. How to set multiple commands in one yaml file with Kubernetes?
  6. What is the use of the pipe symbol in YAML?
  7. OpenAPI query string parameter with list of objects
  8. YAML Multi-Line Arrays
  9. String interpolation in YAML
  10. Schema object without a type attribute in Swagger 2.0
  11. Is it .yaml or .yml?
  12. How can I parse a YAML file from a Linux shell script?
  13. What is the difference between YAML and JSON?
  14. How to specify if a field is optional or required in OpenAPI/Swagger?
  15. Swagger Inheritance and Composition
  16. How to merge YAML arrays?
  17. How do I install the yaml package for Python?
  18. Swagger 2.0: Multiple Path objects with different paths but same request and response
  19. How to define an optional parameter in path using swagger
  20. Parse a YAML file
  21. How does the login check_path route work without default controller/action?
  22. How to allow any arbitrary query parameters using FastAPI and Swagger?
  23. Is there YAML syntax for sharing part of a list or map?
  24. How do you do block comments in YAML?
  25. How to write OpenAPI 3 (Swagger) specification for property name in `map` object?
  26. Escaping a dot in a Map key in Yaml in Spring Boot
  27. Correct MySQL configuration for Ruby on Rails Database.yml file
  28. How to change Swagger-ui URL prefix?
  29. Controlling Yaml Serialization Order in Python
  30. How to document default None/null in OpenAPI/Swagger using FastAPI?

Leave a Comment