Writing OpenAPI (Swagger) Specification Tutorial Series - Part 9

Extending the OpenAPI specification

By Arnaud Lauret, February 19, 2017

This is the end, my OpenAPI friends, the end. The end? Not really. This last part of the OpenAPI tutorial is a new beginning. With previous parts we have learned to master the OpenAPI specification but there’s a last thing to learn to unleash its full power: extensions. This format is easily extensible, it allows to add custom data within an API description. But for what purposes? Let’s have a glimpse of these extensions endless possibilities.


...And GraphQL for all? A few things to think about before blindly dumping REST for GraphQL

By Arnaud Lauret, January 22, 2017

GraphQL is new. GraphQL is cool. Look! Github dumped REST for it! We MUST do it too!
Well, why not. GraphQL could be a great tool, but like any tool, you don’t choose it just because. You choose it because it solves a problem in a given context. You choose it knowing its strengths and weaknesses.


Dr Jekyll and Mr API Handyman

By Arnaud Lauret, December 23, 2016

ICYMI, I’ve just switched from a self hosted Wordpress to a Jekyll static website hosted on Github. The code is available in the repository. If you’re looking for information and tips about how to enable pagination on categories pages and have infinite scroll with Jekyll or how to to deploy a Jekyll website using custom plugins on Github Pages, you should take a look at it.


Read Evolving a Company’s IS in the Lego Computing Age on Nordic APIs blog

By Arnaud Lauret, December 6, 2016

If you wonder how to evolve a company’s IS in the lego computing age, read my post on Nordic APIs blog.


People First: A not so gonzo API Strat Boston 2016 coverage

By Arnaud Lauret, November 19, 2016

The last API Strat 2016 day, after the last talk, a man living in kentucky asked me something like What is the one thing you will remember about this conference?. I answered something like People First.

People First. This is definitely what sticks in my mind after this conference.


The API Stylebook

By Arnaud Lauret, September 10, 2016

I’m a thrilled to announce that is now online. The API Stylebook aims to help API Designers to solve API design matters and build their API design guidelines by providing quick and easy access to selected and categorized resources. Read more on the API Stylebook blog.

Writing OpenAPI (Swagger) Specification Tutorial Series - Part 8

Splitting specification file

By Arnaud Lauret, August 2, 2016

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 APIs by sharing common elements.

Writing OpenAPI (Swagger) Specification Tutorial Series - Part 7


By Arnaud Lauret, June 12, 2016

Previous posts showed how to write a highly accurate description of an API interface contract with the OpenAPI specification. But an interface contract, no matter how brilliant, is nothing without some explainations. A fully documented OpenAPI specification file can provide some useful information and be used as a part of an API’s documentation.

Writing OpenAPI (Swagger) Specification Tutorial Series - Part 6

Defining Security

By Arnaud Lauret, May 22, 2016

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

Advanced Input And Output Modeling

By Arnaud Lauret, May 6, 2016

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.

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