I'm not the first to suggest this, and I know there are reasons it's not concrete in a roadmap. See:
However, I would really like to log this as an idea for voting and visibility.
I would really like to be able to point to both OpenAPI 2 (swagger) and OpenAPI 3 versions of the specification.
Regarding the one endpoint that takes an input stream and makes it "impossible" today - just leave it out of the specs for now. Publish all compliant endpoints.
Even publish it without the one inputstream parameter.
Having OpenAPI specs will make it a breeze to integrate with for instance Azure Logic Apps, or use tools to autogenerate clients. (Like the "good old days" of WSDL)
You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.