OpenAPI (earlier known as Swagger) is considered to be a standard for describing API interfaces and using them in testing. OpenAPI allows you to describe all API capabilities and limitations (available operations, parameters, response formats). The description is used to automate API tests and to ensure mutual compatibility between different tools and services.
API can be described in YAML or JSON formats. The general structure of OpenAPI in YAML format is as follows: