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.


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…


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.


Read How to Provide APIs With an Existing Information System on Nordic APIs blog

By Arnaud Lauret, August 4, 2015

If you want to know why an existing IS is not a good API, you should read my last post on Nordic APIs blog How to Provide APIs With an Existing Information System.


Read Should Every Company Consider Providing an API? on Nordic APIs blog

By Arnaud Lauret, June 10, 2015

My other self Arnaud Lauret writes about APIs too. This week you can read Should Every Company Consider Providing an API? on Nordic APIs blog.


Do you really know why you prefer REST over RPC?

By Arnaud Lauret, May 10, 2015

A few weeks ago I’ve seen an interesting flock of tweets initiated by this question:

This question and the tweets that followed put my brain on quite an animated discussion…


The data, the hypermedia and the documentation

By Arnaud Lauret, April 23, 2015

When I look at hypermedia media-types and API definition languages I feel that the frontier between data and documentation is becoming thinner as my knowledge of the API world grows and as the API world evolves.


The API crash test project

By Arnaud Lauret, April 5, 2015

As I was writing my HAMM and ways of API smartness posts, I wanted more. As I was discussing with smart people about APIs, I wanted ever more. I want to delve deeply into the API ways.

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