APIs connect machines and humans together. They’re the building blocks of the inter-connected digital ecosystem of the 21st century, working in the background to make everything from video games, social media apps to medical devices and aviation systems work.
But while great code is important to make your APIs run, it gets incredibly difficult to communicate the value and functionality of your API, both to internal stakeholders, and external consumers. The OpenAPI Specification (OAS) creates a common framework to define your RESTful API’s functionality, including their resources, and associated request-response cycles. The OAS is both human and machine readable, and acts as the blueprint of your entire API development and delivery.