include.image_alt
OpenAPI Trek Series - Part 2

OpenAPI Trek Into Fastness

By Arnaud Lauret, November 19, 2016
Often reduced to Swagger UI and seen purely as a solution for generating API documentation, the OpenAPI (fka. Swagger) Specification format offers many possibilities that span the full API lifecycle. In this session we will identify some of the many advantages of this API definition from design to production, including topics such as design, mock, development, test, documentation continuous delivery, securely evolve an existing API. All this contributing in accelerating and securing API's lifecycle.
include.image_alt

API Style Guides Fireside Chat with Ronnie Mitra (API Days London 2016)

By Arnaud Lauret, November 17, 2016

API Days London 2016, take 2! I was very happy when Ronnie Mitra (@mitraman) from the API Academy invited me to do a fireside chat on API Style Guides at API Days London.

include.image_alt
OpenAPI Trek Series - Part 1

OpenAPI Trek

By Arnaud Lauret, November 10, 2016
For many still known as Swagger, the OpenAPI specification is often reduce to auto-generated API documentation. But the OpenAPI specification universe is boundless. Design, mock, development, test, documentation continuous delivery, governance, deployment... there are countless possibilities that span the full API lifecycle. Let's board the starship OpenAPI to explore unexpected use cases, to seek out new usage and new ideas, to boldly go where almost no one has gone before.
include.image_alt

HTTP Status Trek (REST Fest 2016)

By Arnaud Lauret, October 1, 2016

I had the luck to go back to REST Fest, this second time was as awesome as last one. Here’s the video and slides of my 5 in 5 about HTTP Status Codes.

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.

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