OpenAPI specification guides and tutorials
Learn how to use OpenAPI to build HTTP APIs that humans and machines can interact with conveniently.
Writing an OpenAPI Document from the Ground Up
A step-by-step guide for authoring OpenAPI documents, starting from the essentials and expanding upon the details of your API.
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.
Using OpenAPI to simplify building and testing Laravel APIs
Dive into the API Design-first workflow with Laravel PHP, leveraging OpenAPI to power your server-side request validations, and build a contracting test suite based off that same API contract.
Augmenting Generated OpenAPI Documents with Filters & Overlays
Enhance and enrich your OpenAPI descriptions without creating conflicts in the source code using filters and overlays.
Generating OpenAPI docs for Ruby on Rails with RSwag
This guide describes, in a code-first approach and RoR codebase, how to generate OpenAPI description documents, enhancing it with contextual information and deploying it to Bump.sh.
Generating OpenAPI docs for Laravel with Swagger-PHP
This guide describes, in a code-first approach and Laravel codebase, how to generate OpenAPI description documents, enhancing it with contextual information and deploying it to Bump.sh.
Code-first: How to Generate OpenAPI from Code
Learn how to generate OpenAPI from an existing codebase.