search

scottie1984 / swagger-ui-express

Adds middleware to your express app to serve the Swagger UI bound to your Swagger document. This acts as living documentation for your API hosted from within your app.
MIT License
1.41k stars 225 forks source link

support of OpenAPI 3.1.* ? #274

Closed yfhui closed 2 years ago

yfhui commented 2 years ago

currently this is using "swagger-ui-dist": "^3.18.1" which according to my understanding, this does not support the new openAPI 3.1.

Consider update to swagger-ui v4 for support of openAPI 3.1 (see this issue in swagger-ui)

Edit: openAPI 3.1 is not offically supported by swagger-ui v4

scottie1984 commented 2 years ago

should be fixed now as part of https://github.com/scottie1984/swagger-ui-express/releases/tag/4.2.0

yfhui commented 2 years ago

great! thanks for the quick response!

yfhui commented 2 years ago

@scottie1984 I think I may have overread something, swagger UI v4.x actually still does not offically support openAPI 3.1 yet. See this line at swagger-ui code at the master branch. But the upgrade to v4 still be good, no need to revert anything.

StephanBijzitter commented 1 year ago

This issue should be re-opened, the line guarding against 3.1 is still in place