VENDOR NEUTRAL APIs - FHIR DevDays...specification for providing technical metadata for REST APIs....

FHIR® is the registered trademark of HL7 and is used with the permission of HL7. The Flame Design mark is the registered trademark of HL7 and is used with the permission of HL7.

Amsterdam, 15-17 November | @fhir_furore | #fhirdevdays17 | www.fhirdevdays.com

VENDOR NEUTRAL APIs

Mo Alkady, Hart

17,000+ APIs available today

Developers today face incomplete API documentation, random documentation and even lacking

documentation.

Building a vendor-neutral, portable and open specification for providing technical metadata for REST

APIs.

Imagine being able to understand any API by

just reading the documentation.

2010Tony Tam @Wordnik founded Swagger

Q1 2015Swagger acquired by SmartBear

Q3 2015 Linux Foundation Workgroup Forms

Q4 2015 Swagger renamed OpenAPI Specification

2010 - 2014Development, Growth, Adoption, Tooling, Community

Swagger is the most popular API framework with over 100k visitors every

month and 11k+ downloadsper day

Programmers are lazy efficient

Let’s put the docs in the

code.

Language Neutral

& Machine Readable Format

APIs can be defined in

JSON or YAML

API-First & Code-First

Development

Powerful Extension

Mechanism

Comprehensive Tooling Support (core, UI, codegen, editor)

Let’s just code!

What Spec? Spec Generates

Code

Spec as

Code

Code is

Spec

Build docs by processing

JSON/YAML API Spec

The API Spec can be returned from static source or from the

running API

Let’s start with the API

Spec!

Commitment to Remain

OpenPortable

Vendor Neutral

Strong Independent Sponsorship

CommunitySimple & Pragmatic

Superior Tooling Best Industry Support

There are of course some challenges, that are both internal and external

There are of course some challenges, that are both internal and external

Seeing custom APIs as competitive edge

Lack of investment in open source

Seeing APIs as a secondary need to their software

We can’t make everyone happy

APIs are getting more and more complex

Framework or specification?

+

Website: https://openapis.org/

Spec: https://github.com/oai

Follow: @OpenApiSpec