Writing OpenAPI (Swagger) Specification Tutorial Series - Part 3

Simplifying specification file

By Arnaud Lauret, March 19, 2016

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.

Writing OpenAPI (Swagger) Specification Tutorial Series - Part 2

The basics

By Arnaud Lauret, March 2, 2016

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 (Swagger) Specification Tutorial Series - Part 1


By Arnaud Lauret, March 2, 2016

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 The Utopia Of API Documentation on Smartbear Blog

By Arnaud Lauret, December 18, 2015

Jennifer Riggins wrote a blog post about my Document-API-topia talk, you can read the Utopia of API documentation on Smartbear blog.


API Days Paris 2015 with a lightsaber

By Arnaud Lauret, December 11, 2015

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.


Document-API-topia (API Days Paris 2015)

By Arnaud Lauret, December 8, 2015

I gave a Star Wars themed talk with a lightsaber about my new passion, documentation, at API Days Paris 2015.

Yes, a talk about D-O-C-U-M-E-N-T-A-T-I-O-N. Yes, a S-T-A-R W-A-R-S themed talk. Yes, I gave this talk holding a L-I-G-H-T-S-A-B-E-R.


Starting a Swagger journey beyond generated Swagger UI

By Arnaud Lauret, October 7, 2015

When watching a movie, have you ever noticed how characters interact with computers? If someone wants to destroy a computer, what does he or she smash?
The computer’s screen…


A quest for simplicity (API Days London 2015)

By Arnaud Lauret, September 23, 2015

A ROAST API is a SOAP API made by people who have vaguely heard of REST API

Right after REST Fest, I had the honor to give my first keynote at the first edition of API Days London in September 2015.

Join me in a quest for simplicity from an imaginary bank’s IS depth to its API’s heights.


Don't mess with hypermedia controls (REST Fest 2015)

By Arnaud Lauret, September 18, 2015

I had the pleasure to participate to REST Fest 2015, here are my 5 in 5 video and slide deck about hypermedia controls. If you can attend only one API conference, this is the one.


Interview with an API Handyman

By Arnaud Lauret, September 3, 2015

I’ve been interviewed by Lexy Mayko from API2Cart, you can read the interview here.

By continuing to use this web site you agree with the API Handyman website privacy policy (effective date , June 28, 2020).