Tag: swagger

Generating Executable API Documentation for Ruby on Rails with RSwag

June 9, 2025 A structured exposition with illustrative examples Abstract Accurate, current, and machine-readable documentation is a prerequisite for reliable consumption of web APIs. While manual Swagger (OpenAPI) definitions quickly diverge from production behaviour, RSwag bridges this gap by synthesising documentation directly from integration tests written in RSpec. This article (i) situates RSwag within the … Continue reading Generating Executable API Documentation for Ruby on Rails with RSwag →

Building APIs in Ruby with Sinatra or Rails

November 12, 2024 Building an API (Application Programming Interface) is a common task in web development today. APIs allow different applications to communicate with each other, share data, and perform various tasks without a direct user interface. Ruby, one of the most flexible and developer-friendly languages, offers two powerful frameworks—Sinatra and Ruby on Rails—both of … Continue reading Building APIs in Ruby with Sinatra or Rails →