Post on 22-May-2020
transcript
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