Orange-OpenSource / angular-swagger-ui

An angularJS implementation of Swagger UI
http://orange-opensource.github.io/angular-swagger-ui/
MIT License
135 stars 74 forks source link

Question: Benefits & Comparisons #89

Open mikefidel opened 6 years ago

mikefidel commented 6 years ago

What are the benefits of running angular-swagger-ui versus just redirecting the user to a web page containing Swagger-UI configured with the desired openapi v3 JSON specification file?

I ask because we have a Swagger-UI instance running in an AWS S3 bucket already. There are thoughts about integrating it into an organization's AngularJS front end. Its believed that sandwiching the AngularJS front-end header and trailer will have a better appearance. Seeking examples on how to do this, ... well, I found this project. It looks well suited to our needs (i.e. supports openapi v3 and basic auth).

I am just looking for confirmation that this project has the right "fit", and what you think its merits are when compared to doing an html redirect to the S3 bucket.

Thanks for your input.

mathieuales commented 6 years ago

Hi! Sorry for delayed response... Not easy to answer this question :) ! It depends on what is the main goal of your app, and lots of other things

The benefits of using this component are:

We had the same questioning on a big project of my compny and we choosed the fully integrated solution. I came up creating this component as no other solution was complete enough in AngularJS.

Hope this helps! Regards

mikefidel commented 6 years ago

Exactly the depth and detail of information I was looking for. Thanks@mathieuales.