What is OpenAPI?
OpenAPI is a standardized technical specification to make describing the capabilities of the API unambiguous for both humans and machines. Why this is desirable requires a brief tangent on APIs and the problem of asymmetric information. APIs are like contracts. The terms of the contract must be clear and unambiguous