Posts

The API Handyman writes as time permits

Writing OpenAPI (Swagger) Specification Tutorial - Part 4 - Advanced Data Modeling

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.

Read more

Writing OpenAPI (Swagger) Specification Tutorial - Part 3 - Simplifying specification file

After learning the basics and having written a little bit huge file for a so simple API, you may be concerned by what nightmare it could be to handle a bigger and more complex API. REST assured that the OpenAPI Specification (formerly Swagger Specification) format offers all means to write really small and simple specification files whatever the described API’s size and complexity.

Read more

Writing OpenAPI (Swagger) Specification Tutorial - Part 2 - The Basics

After discovering what is the OpenAPI Specification format, it’s now time to write a first simple OpenAPI Specification file to learn the basics.

Read more

Writing OpenAPI (Swagger) Specification Tutorial - Part 1 - Introduction

Previously in the APIverse…
Since I started my Swagger journey, there have been some changes. The Swagger Specification has been donated to the newly created OpenAPI Initiative under the Linux foundation and is reborn as the OpenAPI Specification. Therefore, my Swagger Journey will become an OpenAPI Specification (fka Swagger Specification) Journey.

Read more

API Days Paris 2015 with a lightsaber

API Days Paris just finished this Thursday, leaving me both sad and exhausted and happy and full of energy.

Sad and exhausted because this awesome and intense API conference is over.
Happy and full of energy because this awesome and intense API conference exists.

Read more