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 apihandyman.io 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
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 5
Advanced Input And Output Modeling
By Arnaud Lauret, May 6, 2016
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.