OpenAPI specification guides and tutorials
Learn how to use OpenAPI to build HTTP APIs that humans and machines can interact with conveniently.
Paths and Operations
Learn how to build OpenAPI descriptions using path and operations.
Defining Parameters
Teach OpenAPI all about the headers, query params, and path parameters in your API.
Parameter Serialization
Follow through examples of how your parameters will be serialized.
OpenAPI Components
Reduce repetition in your OpenAPI documents with shared components.
Basic Structure
Learn your way around the OpenAPI description format for HTTP APIs by learning the basic structure.
Defining API Servers
Learn about the API Servers section of the OpenAPI Specification.
How to use JSONPath
JSONPath is a query language that can be used to extract data from JSON documents, powering OpenAPI Overlays amongst other useful functionality in the world of APIs.
OpenAPI v4.0 (A.K.A "Project Moonwalk")
What is coming next for OpenAPI, as v4.0 of the OpenAPI Specification gets closer to being released? What major changes are coming, how easy will it be to upgrade, and how do tooling companies feel about it?
Creating an API with Express.js using OpenAPI
This tutorial walks you through the creation of a REST API in a Node.JS enviromnent, and its documentation using Bump.sh.
Using OpenAPI to simplify building and testing Ruby on Rails APIs
In a Design-first approach and RoR API, leverage OpenAPI to verify specific request responses or write a test suite for your complete API contracts.