OpenAPI is a description format for RESTful APIs that you can use to describe the capabilities and expectations of the API. An API description helps developers understand how to interact with the API. And for those who implement the API, the description is an agreed-upon understanding of the functionality. The API description helps teams implement APIs much faster and with confidence that the requirements are being met.
There are numerous tools for designing APIs, including Oracle Apiary, Stoplight, SmartBear, and Postman, just to name a few. You can use whatever tool you want and add your API description into API Gateway for use throughout the API management lifecycle.
Use case: Create an API deployment from the description
The API deployment specification is the configuration of the API on the gateway. You can create the deployment directly by using the Oracle Cloud Infrastructure Console, CLI, SDK, API, or Terraform. However, much of the required information, such as paths and methods, are already defined in the API description. Read the complete article here.
For regular information become a member in the Developer Partner Community please register here.