openapi8

With previous posts we have learned to produce an OpenAPI specification containing all OpenAPI specification subtleties. Some specification files may become quite large or may contain elements which could be reused in other APIs. Splitting a specification file will help to keep it maintainable by creating smaller files and also help to ensure consistency throughout… Read More


Screen Shot 2016-05-22 at 18.23.43

After mastering input and output modeling like a Jedi, let’s see how we can describe API’s security with the OpenAPI specification’s. Writing OpenAPI (fka Swagger) Specification tutorial This tutorial is composed of several posts: Part 1: Introduction Part 2: The basics Part 3: Simplifying specification file Part 4: Advanced data modeling Part 5: Advanced input… Read More


Screen Shot 2016-05-06 at 20.27.26

After learning how to create an accurate data model, we continue to delve into the OpenAPI specification’s and discover how to describe tailor made API’s inputs and outputs. Writing OpenAPI (fka Swagger) Specification tutorial This tutorial is composed of several posts: Part 1: Introduction Part 2: The basics Part 3: Simplifying specification file Part 4:… Read More


Screen Shot 2016-04-17 at 17.48.41

After learning how to simplify specification files, let’s start delving into the OpenAPI specification’s and discover how to describe a high accuracy API’s data model. Writing OpenAPI (fka Swagger) Specification tutorial This tutorial is composed of several posts: Part 1: Introduction Part 2: The basics Part 3: Simplifying specification file Part 4: Advanced data modeling… Read More


thebasics

After discovering what is the OpenAPI Specification format, it’s now time to write a first simple OpenAPI Specification file to learn the basics. Writing OpenAPI (fka Swagger) Specification tutorial This tutorial is composed of several posts: Part 1: Introduction Part 2: The basics Part 3: Simplifying specification file Part 4: Advanced data modeling Part 5:… Read More