Convert ManageIQ REST API to leverage OpenAPI

[chessbyte]

This will enable the following

• Auto-generated Clients
• Auto-generated Documentation
• GraphQL

[Fryguy]

• [API] Convert to OpenAPI manageiq-api#717
• [API] GraphQL based on OpenAPI manageiq-api#718

[miq-bot]

This issue has been automatically marked as stale because it has not been updated for at least 3 months.

If you can still reproduce this issue on the current release or on master, please reply with all of the information you have about it in order to keep the issue open.

Thank you for all your contributions! More information about the ManageIQ triage process can be found in the traige process documentation.

[nateKlaux]

Do you still need rest API documentation in OAS??

[Fryguy]

@nateKlaux Yes, this issue is still open...ideally we can reuse the api.yml file somehow to "build" an OpenApi Specification file.

[nateKlaux]

@Fryguy Thanks for the response Jason! Sounds great. I'll try to allocate some time to research this further (hopefully) either today or tomorrow. Initial thoughts are hopeful that we can reuse the api.yml file, esp. if OAS was in mind during the creation of the API. :) Thanks for getting back to me, looking forward to helping out