include.image_alt

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.

include.image_alt

The API Stylebook

By Arnaud Lauret, September 10, 2016

I’m a thrilled to announce that apistylebook.com 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

include.image_alt
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.

include.image_alt
Writing OpenAPI (Swagger) Specification Tutorial Series - Part 7

Documentation

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.

include.image_alt
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.

include.image_alt
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.

include.image_alt
Writing OpenAPI (Swagger) Specification Tutorial Series - Part 4

Advanced Data

By Arnaud Lauret, April 17, 2016

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.

include.image_alt
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.

include.image_alt
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.

include.image_alt
Writing OpenAPI (Swagger) Specification Tutorial Series - Part 1

Introduction

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.

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