As we know, Open API 3.0 was released on July, 2017, it is about one year ago. Open API 3.0 support some new features like anyof, oneof and allof than Open API 2.0(Swagger 2.0). Now OpenStack projects do not support Open API. Based on Open API 3.0, it can bring lots of benefits for OpenStack Community and does not impact the current features the Community has. For example, we can automatically generate API documents, different language Clients(SDK) maybe for different micro versions, and generate cloud tool adapters for OpenStack, like ansible module, terraform providers and so on. Also we can make an API UI to provide an online and visible API search, API Calling for every OpenStack API. 3rd party developers can also do some self-defined development.
OpenStack needs a stardard way to describe OpenStack APIs, we can describe OpenStack APIs based on Open API which is used by lots of projects like kubernetes. The complete OpenStack API description(schema) will bring lots of benefit for OpenStack Community and also provide self-defined development for 3rd party developers.
