OpenAPI : Fostering a vendor-neutral ecosystem of APIs

Pablo Fernandez
ISA Group
Published in
3 min readJan 31, 2018

The Open API Initiative (OAI) was created by a consortium of forward-looking industry experts who recognize the immense value of standardizing on how REST APIs are described. As an open governance structure under the Linux Foundation, the OAI is focused on creating, evolving and promoting a vendor neutral description format.

http://openapis.org

Currently, OpenAPI has gained traction involving a growing number of companies and research centers in order to collaborate in its activities and the creation of a tooling ecosystem to help developers and architects.

Current OpenAPI Members (as of 01/10/2017)

This article summarizes the main parts of the presentation at ICSOC17 with links of the screen-casts of the key parts in the talk. During the presentation we covered why this Initiative is interesting (Benefits), which is the current status of the OpenAPI Specification (OASv3), what is the ecosystem of Tooling available and , finally we present a technical Hands-On that shows the benefits of using OAS in real developments. The full talk (57m) is available in this link.

Benefits

With the consolidation of Micro-services architectures REST APIs are becoming the cornerstone that drive the integration and evolution on most infrastructures. In the following short video fragment (~7m) we present an introduction of these architectures and the REST Paradigm to identify why an standard specification can help.

Open API Benefits

OpenAPI Specification v3

The main goal of OAI is the development of an standard way of specifying a REST API; specifically, the key outcome of the initiative is the OpenAPI Specification (OAS) that is currently under its version 3 (as Dec. 2017). In the following short video fragment (~7m) we review the main elements of the specification showing simple examples and identify the new features introduced in the last version.

OpenAPI Spec v3 Introduction

Tooling Ecosystem

One of the most important benefits of OAI is the growing ecosystem of tools build by the community that help in different parts of the API development lifecycle: from modelling or documenting to the testing. In the following short video fragment (~5m) we review the different kinds of tools and some examples of them.

OAI Tooling Ecosystem

Hands-on: From 0 to API with OpenAPI

In order to see the Open API Specification in action, in this hands-on (~20m), we present a concrete example where we build from scratch a fully-working API in few minutes. Specifically, we present how we can generate a complete API scaffolding in NodeJS (using Swagger Editor), how we can document it (with Swagger UI ) and test it (usig oatts).

Pablo Fernandez is a Researcher at ISA Group in the University of Sevilla, contact him at (pablofm at us.es)

--

--

Pablo Fernandez
ISA Group

Cloud Service Engineering Researcher at ISA Group - University of Sevilla