New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Upgrade Pender service to provide a UI to its API via OpenAPI #8
Comments
I'd like to attempt this |
I tried using rswag to generate Swagger YAML/JSON and swagger-ui from rspec-rails specifications. So far it works well, the only issue is that rswag does not provide a way to convert OpenAPI 3.x JSON/YAML files to Markdown, to replace |
Apparently pender/doc/api.md is no longer in line with the Swagger JSON anyways, so one option is to get rid of the Alternately, we can use widdershins to convert OpenAPI 3.x JSON/YAML files to Markdown, and update the new OpenAPI definition to match the current Since this will potentially require a lot more effort, I will need a confirmation before continuing to work on this. So far I've successfully used rswag to generate OpenAPI 3.x YAML/JSON files for the controllers, and displayed them using rswag's embedded |
Hi @daniel-shuy,
Yes, it's an acceptable tradeoff and a great contribution.
You can keep working in this solution, it seems to be a good approach |
@danielafeitosa Thanks for the confirmation! I've created a PR at meedan/pender#233 |
Tell us about your request
Pender currently uses Swagger 0.x to expose its API on a web page. Upgrade Swagger to use the latest version of OpenAPI (3.x). Evaluate OpenAPI Generator as possible technology.
Tell us about the problem you're trying to solve. What are you trying to do, and why is it hard?
Testing and debugging an API during development is much easier when a UI exists to make API calls.
The text was updated successfully, but these errors were encountered: