OAS 3.0 Support Backlog

⚠️ Note to onlookers: don’t rely on this information, this issue is out of date! We’re breaking everything here out into their own issues soon.

This is a collection ticket for OAS3 specification features that are not yet supported by Swagger-UI.

Items that affect both UI and Client will be listed here as well, but Client-only items will be filed in the Client issue tracker.

Significant items should be broken out into their own ticket when work begins, but simple items can be addressed as a line item here.

Rendering

• Parameter example/examples is not displayed

#3616 is open for this. Implement functionality for Try-It-Out simultaneously.

• Parameter style/explode is not displayed

• Parameter allowReserved is not displayed

• Parameter content is not displayed

Reuse method for displaying Request Bodies Render all media types, even though only one is allowed by the specification

• Media type example/examples is not displayed

Identical to Request Body, Parameter content

• Callbacks are not rendered
• Media type encoding is not displayed

This has lots of moving parts before it’s useful: breaking down jsonschema, rendering individual inputs, handling file uploads, etc

• Discriminator objects are not displayed

This will change the way we display allOf, anyOf, oneOf, not.

• Link-level servers are not displayed

Try-It-Out

• Parameter style/explode is not considered in request construction

Needs support in Swagger-Client, mostly. Important!

• Links can’t be used to stage another operation
• Link-level servers are not available for executing requests
• Parameter content values are not rendered for Try-It-Out
• Parameter encoding values are not considered
• Blacklisted header names (Accept, Content-Type, Authorization) are not filtered out
• Path and operation-level servers are not available for executing requests
• Parameter allowEmptyValue is not considered in request value validation

Add a checkbox that allows construction of a request with that parameter empty (may require value validation changes) if ‘send empty value’ is checked - you’re sending an empty value meaning the requirement is satisfied Implementation may be best served by a split of Client’s buildRequest based on definition version

• Security type openIdConnect is not supported
• Form Data:
  • Nested object serialization is not handled correctly (#3788)
  • Form data fields should be displayed as items instead of a JSON object
  • File upload UI should appear when applicable

[beltschatsar]

Hi,

Can we have status about this missing feature ?

Try-it-out

• Links can’t be used to stage another operation

So that an api call output can serve as input for another call (as explained there: https://swagger.io/docs/specification/links/)

Thanks!

[amarel123]

File upload UI should appear when applicable

What is the current progress? It’s very useful option.