SlideShare a Scribd company logo
BILL
DOERRFELD
@DoerrfeldBill
Austin API
Summit 2019
A Snapshot of API Design
Trends In 2019
Nordic APIs Community
API Tooling, Vendors
API Consumers, Developers
Thought Leaders, Bloggers
API Owners, Practitioners
Blog, Digest
Events
Community Submissions
Are Welcome
bill@nordicapis.com
5 Major API Design Trends
Developer Experience
● Context
● Bare Minimum
● Extra Tweaks
● Shining Examples
DX: Context
● Huge business driver
● Part of platform strategy
● Internal/Partner/Public can
all benefit
DX: Bare Minimum
Authentication Scheme
HTTP Call Types
Endpoint
URI Structures,
Methods, and Paramete
Basic things you need to consume a web API
DX: Getting Better
Getting
Started
Guide
Human Readable
Method
Descriptions
Testing
Environment
Sample Requests and
Examples
Caters better to self-service models
DX: Extra Tweaks
Instant Load
Rate this Page
Dark Mode
Status
Widget
Featured
Topics
Click to
Copy
Searchability
Impressive additions to increase efficiency
DX: Shining Examples
TwilioStripe
Github Shopify
- Adeel Ali, CEO of APIMatic,
Speaking @ Nordic APIs Platform Summit, 2018
DX: Remove Redundancy
“The golden principle of
developer experience – remove
the redundancy from the life of
developers”
GraphQL
● Context
● Benefits
● 4 Examples in the Wild
● Tooling
GraphQL: Context
A valid descriptor within GraphQL:
A simple request:
A simple result:
● Application
query
language
● Facebook
origin
● Unifies
request and
data retrieval
process
GraphQL: Benefits
Simplicity : More elegant data retrieval
Efficiency: Packaging data into single request
Stability : Single point of entry, community support
Low Overhead : GraphQL is a specification = compatibility
Learnability : improves understanding and organization
AWS AppSync
One GraphQL example in practice
GraphQL used to interact with app data
"AWS AppSync is an enterprise level, fully managed GraphQL service with
real-time data synchronization and offline programming features."
GraphQL at AirBnb
Supporting "Backend-Driven UI" at Airbnb
Interactive GraphQL IDE from
"Airbnb is moving 10x faster at scale with GraphQL and Apollo" - Adam Neary,
AirBnB
GraphQL at Twitter
Aiding the microservices model
Used for subscriptions at
"Clients subscribe to an event with a GraphQL query and receive payloads" -
Laney Kuenzel
SOURCE: https://about.sourcegraph.com/graphql/graphql-at-twitter
GraphQL at Walmart
Data retrieval using open source library
Lacinia by
"We’ve been using GraphQL in production for over a year for multiple services." -
Brandon Carrell, Software Engineer, eReceipts @WalmartLabs
GraphQL: Tooling
GraphiQL
Voyager
graphdoc
GraphQL schema documentation
Explore as interactive graph
in-browser IDE for exploring
GraphQL
- Lee Byron, GraphQL Co-Creator
Interviewed by Nordic APIs, Fall 2018
On GraphQL Growth
“there’s a ton of large companies
that are using GraphQL and that’s
only three years out from
open-sourcing. I think that’s pretty
incredible but there’s always room
to grow”
OpenAPI Specification
● Context
● Use Cases
● Community
● Sample Code
● Tooling
A specification for creating
machine-readable interface files
for describing, producing,
consuming, and visualizing web
services in a RESTful
architecture.
OpenAPI: Context
What Is It?
OpenAPI: Use Cases
What Is It Good For?
Documentation : Generate descriptive docs
Gen: Auto generate libraries & SDKs
Design-First : A more modern, standard API dev process
Testing : Declarative resource specification enables better
testing/exploration/sandboxing.
Benefits : Speed, security, auto-generation
OpenAPI: Community
From Swagger to Linux Foundation
● 2016: Linux
Foundation
● 30+ members
● v3.0.2
● 2011, Tony Tam
● Smartbear
● Wordnik
OpenAPI: Sample Code
Both written in YAML
OpenAPI: Tooling
Many open source generators, validators, linters, etc.
SwaggerUI
ReDoc
Swagger Codegen
API client libraries (SDK generation),
server stubs and documentation
Open source doc generator alternative w/ many benefits
A widely used API documentation
generator
Why Adopt OpenAPI Spec?
"The OpenAPI specification can be
used to accelerate and secure API
creation and evolution."
-Arnaud Lauret, The API Handyman
Nordic APIs Platform Summit 2018
AsyncAPI
● Context
● Protocols
● Community
● Benefits/Drawbacks
● Sample Code
● Tooling
Event-Driven Architecture
ASYNCHRONOUS
MESSAGE-BASED
STREAMING
AUTOMATED
=ALT. PROTOCOLS
WEBSOCKETS
WEBHOOKS
CALLBACKS
REST HOOKS
POLLING
PUB-SUB
Some argue REST doesn't meet these new styles
AsyncAPI: Context
A specification for
documenting
event-driven APIs
Because event-driven APIs need love too!
AsyncAPI: Protocols
Protocols good for documenting with AsyncAPI. *under consideration
AMQP
MQTT
WebSocket
Kafka
CoAP*
Others Include:
HTTP
JMS
STOMP
NATS*
Google Cloud
Pub/Sub*
AsyncAPI: Community
● Fran Méndez, Project Director
● Origin: Hitch, API Changelog
● AsyncAPI Initiative
AsyncAPI: Sample Code
Info Object Define Servers
Events Object - holds send and receive operations
AsyncAPI: Benefits
Protocol Agnostic: Custom header definitions in messages
Open Source : Community inspection, industry growth
Machine Readable : Creates definitions machines can read
Human Readable : Use to generate docs, sandboxes, etc.
Use Cases : Asynchronous, message-driven, DevOps,
microservices, SaaS, IoT, & more.
AsyncAPI: Tooling
Playground
Validator
AsyncAPI Generator
Creates AsyncAPI spec from Go
message structures
Supports AsyncAPI
generate documentation in multiple
formats
https://playground.asyncapi.io/
Markdown documentation, Node.js
code, HTML documentation
AsyncAPI Generator
What Others Think
"Microservices underline the
need for event-based
communication in distributed
architectures. AsyncAPI brings the
richness of the REST API ecosystem to
asynchronous APIs
-Matt McClarty, MuleSoft
OAuth + OpenID Connect
● Open Standard
● Security Context
● Scopes
● Benefits
● Implementation
Options
Security = Paramount
Holistic Platform Perspective
APIs
GDPR
IoT
Mobile Apps
Website, Desktop
OAuth: Context
● Industry-standard
● Most web APIs adopt
OAuth is an open standard for
delegation and authorization
on the internet
OpenID Connect: Context
● Verify identity
● Gather user information
● REST-like
An identity-centric
authentication protocol that
builds on the OAuth standard
OAuth Flows and Powers
1. Authorization Code Grant
2. Implicit Flow
3. Client Credentials Flow
4. Resource Owner Password
Credentials Flow
5. Dynamic Client Registration
6. Assisted Token Flow
7. Introspection
8. Revocation
https://nordicapis.com/8-types-of-oauth-flows-and-powers/
Example: Implicit Flow
● Browser based
OAuth + OpenID Connect
"OAuth (and more recently
OpenID Connect) is the golden
standard for giving clients
secure access to a user’s data
in a transparent and controlled
fashion."
-Thomas Bush, Nordic APIs Blog
There's The 5 Design Trends!
But what's happening outside of API design?
New API Sectors in 2019
● Retail
● eCommerce
● MarTech
● Banking
● DevOps
● AI
● Business
● others...
Don't Adopt Trends on Face Value
"Boring is best."
-Martin Buhr,
Nordic APIs Platform Summit 2018
Some Practical API Design Tips
1. Understand The REST Standard
2. Use the Right HTTP Method
3. Know How to Define Resources
4. Use Sub-resources
5. Do not Use Java Method Name Patterns
6. If You Do Version Your REST Service, Do So Consistently
7. JSON Over XML For Most Cases
8. Return the Right Status Code
-Adriano Moto, Ford
Writing on The Nordic APIs Blog
BILL
DOERRFELD
@DoerrfeldBill
Austin API
Summit 2019
A Snapshot of API Design
Trends In 2019
THANK YOU
slideshare.net/BillConradDoerrfeld
Slides are up:
Subscribe:
https://nordicapis.com/newsletter/
Share Your API Story
Articles, LiveCasts, Platform Summit 2019
CONTACT
bill@nordicapis.com
@DoerrfeldBill
BILL
DOERRFELD
@DoerrfeldBill
Austin API
Summit 2019
A Snapshot of API Design
Trends In 2019

More Related Content

What's hot (20)

PDF
apidays LIVE Australia 2021 - Confessions of a Product Geek : My First API BY...
apidays
 
PPTX
INTERFACE, by apidays - The 8 Key Components of a Modern API Stack by Iddo G...
apidays
 
PDF
APIDays - API Design Workshop
Restlet
 
PDF
APIdays Zurich 2019 - Digital Ecosystems, fueled by APIs Matthias Biehl, API ...
apidays
 
PDF
The Architecture of an API Platform
Johannes Ridderstedt
 
PDF
apidays LIVE Paris 2021 - What Developers Want by Paul Ardeleanu, Vonage
apidays
 
PDF
APIdays Helsinki 2019 - How to Minimize Coupling in API Production and Consum...
apidays
 
PDF
API Design in the Age of Bots, IoT, and Voice
LaunchAny
 
PDF
apidays LIVE Paris 2021 - Building an analytics API by David Wobrock, Botify
apidays
 
PPTX
APIStrat 2017: API Design in the Age of Bots, IoT, and Voice
LaunchAny
 
PPTX
Architecture for the API-enterprise
Apigee | Google Cloud
 
PPTX
O'Reilly author webinar "APIs: A Strategy guide": Transforming Your Business...
Apigee | Google Cloud
 
PDF
APIdays Zurich 2019 - API management for event driven microservices, Fran Men...
apidays
 
PDF
apidays LIVE Paris 2021 - 5 Learnings Shaping Our View on the Future of APIs ...
apidays
 
PDF
API Maturity Model (Webcast with Accenture)
Apigee | Google Cloud
 
PPTX
APIdays Helsinki 2019 - Research on APIs in the Platform Economy with Marko S...
apidays
 
PDF
apidays LIVE Paris 2021 - API Terms of Service by Benjamin Jean & Célya Gruso...
apidays
 
PDF
apidays LIVE Hong Kong 2021 - Event-driven APIs & Schema governance for Apach...
apidays
 
PDF
[API Word 2021] - Quantum Duality of “API as a Business and a Technology”
WSO2
 
PPTX
Api-First service design
Stefaan Ponnet
 
apidays LIVE Australia 2021 - Confessions of a Product Geek : My First API BY...
apidays
 
INTERFACE, by apidays - The 8 Key Components of a Modern API Stack by Iddo G...
apidays
 
APIDays - API Design Workshop
Restlet
 
APIdays Zurich 2019 - Digital Ecosystems, fueled by APIs Matthias Biehl, API ...
apidays
 
The Architecture of an API Platform
Johannes Ridderstedt
 
apidays LIVE Paris 2021 - What Developers Want by Paul Ardeleanu, Vonage
apidays
 
APIdays Helsinki 2019 - How to Minimize Coupling in API Production and Consum...
apidays
 
API Design in the Age of Bots, IoT, and Voice
LaunchAny
 
apidays LIVE Paris 2021 - Building an analytics API by David Wobrock, Botify
apidays
 
APIStrat 2017: API Design in the Age of Bots, IoT, and Voice
LaunchAny
 
Architecture for the API-enterprise
Apigee | Google Cloud
 
O'Reilly author webinar "APIs: A Strategy guide": Transforming Your Business...
Apigee | Google Cloud
 
APIdays Zurich 2019 - API management for event driven microservices, Fran Men...
apidays
 
apidays LIVE Paris 2021 - 5 Learnings Shaping Our View on the Future of APIs ...
apidays
 
API Maturity Model (Webcast with Accenture)
Apigee | Google Cloud
 
APIdays Helsinki 2019 - Research on APIs in the Platform Economy with Marko S...
apidays
 
apidays LIVE Paris 2021 - API Terms of Service by Benjamin Jean & Célya Gruso...
apidays
 
apidays LIVE Hong Kong 2021 - Event-driven APIs & Schema governance for Apach...
apidays
 
[API Word 2021] - Quantum Duality of “API as a Business and a Technology”
WSO2
 
Api-First service design
Stefaan Ponnet
 

Similar to A Snapshot of API Design Trends In 2019 (20)

PPTX
Super simple introduction to REST-APIs (2nd version)
Patrick Savalle
 
PDF
Livecast: API Usability & Developer Experience
Nordic APIs
 
PDF
Space Camp June 2022 - API First.pdf
Postman
 
PDF
Consumer centric api design v0.4.0
mustafa sarac
 
PPTX
Past, Present, Future of APIS
Jason Harmon
 
PDF
Intuitive APIs and Developer Education
Postman
 
PDF
GlueCon 2015 - How REST APIs can glue all types of devices together
Restlet
 
PDF
Past, Present and Future of APIs of Mobile and Web Apps
SmartBear
 
PDF
APIs : Mapping the way
WSO2
 
PPTX
Open API Specification - SiliconValley Code camp 2017 session @siddiqimuhammad
Muhammad Siddiqi
 
PDF
Api design best practice
Red Hat
 
PDF
Cloud Elements | State of API Integration Report 2018
Cloud Elements
 
PPTX
Reaching 1 Million APIs and what to do when we get there
3scale
 
PPTX
API and Platform Strategies to Win in Global and Local Markets
Axway
 
PDF
API Best Practices
EmmanuelParaskakis1
 
PDF
Netflix OSS and HATEOAS deployed on production - JavaLand
JWORKS powered by Ordina
 
PPTX
Api design part 1
Ibrahim Elsawaf
 
PDF
Designing an API
Twobo Technologies
 
PPTX
2022 APIsecure_Securing APIs with Open Standards
APIsecure_ Official
 
Super simple introduction to REST-APIs (2nd version)
Patrick Savalle
 
Livecast: API Usability & Developer Experience
Nordic APIs
 
Space Camp June 2022 - API First.pdf
Postman
 
Consumer centric api design v0.4.0
mustafa sarac
 
Past, Present, Future of APIS
Jason Harmon
 
Intuitive APIs and Developer Education
Postman
 
GlueCon 2015 - How REST APIs can glue all types of devices together
Restlet
 
Past, Present and Future of APIs of Mobile and Web Apps
SmartBear
 
APIs : Mapping the way
WSO2
 
Open API Specification - SiliconValley Code camp 2017 session @siddiqimuhammad
Muhammad Siddiqi
 
Api design best practice
Red Hat
 
Cloud Elements | State of API Integration Report 2018
Cloud Elements
 
Reaching 1 Million APIs and what to do when we get there
3scale
 
API and Platform Strategies to Win in Global and Local Markets
Axway
 
API Best Practices
EmmanuelParaskakis1
 
Netflix OSS and HATEOAS deployed on production - JavaLand
JWORKS powered by Ordina
 
Api design part 1
Ibrahim Elsawaf
 
Designing an API
Twobo Technologies
 
2022 APIsecure_Securing APIs with Open Standards
APIsecure_ Official
 
Ad

More from Bill Doerrfeld (6)

PDF
Always Mind Your [Developer] Surroundings - API City 2018
Bill Doerrfeld
 
PDF
API World 2018 - 7 Global Movements Evolving the Story of APIs
Bill Doerrfeld
 
PDF
Seattle APIs and IPAs - June 21 - 7 Global Movements That Are Evolving The St...
Bill Doerrfeld
 
PDF
14 API Directories
Bill Doerrfeld
 
PDF
Ultimate Guide to 30+ API Documentation Solutions
Bill Doerrfeld
 
PDF
Introduction to the Art of API Practice
Bill Doerrfeld
 
Always Mind Your [Developer] Surroundings - API City 2018
Bill Doerrfeld
 
API World 2018 - 7 Global Movements Evolving the Story of APIs
Bill Doerrfeld
 
Seattle APIs and IPAs - June 21 - 7 Global Movements That Are Evolving The St...
Bill Doerrfeld
 
14 API Directories
Bill Doerrfeld
 
Ultimate Guide to 30+ API Documentation Solutions
Bill Doerrfeld
 
Introduction to the Art of API Practice
Bill Doerrfeld
 
Ad

Recently uploaded (20)

PPTX
Employee salary prediction using Machine learning Project template.ppt
bhanuk27082004
 
PDF
10 posting ideas for community engagement with AI prompts
Pankaj Taneja
 
PPTX
Cutting Optimization Pro 5.18.2 Crack With Free Download
cracked shares
 
PPTX
Chess King 25.0.0.2500 With Crack Full Free Download
cracked shares
 
PDF
Balancing Resource Capacity and Workloads with OnePlan – Avoid Overloading Te...
OnePlan Solutions
 
PPTX
slidesgo-unlocking-the-code-the-dynamic-dance-of-variables-and-constants-2024...
kr2589474
 
PDF
Download iTop VPN Free 6.1.0.5882 Crack Full Activated Pre Latest 2025
imang66g
 
PDF
AI Software Engineering based on Multi-view Modeling and Engineering Patterns
Hironori Washizaki
 
PDF
Enhancing Security in VAST: Towards Static Vulnerability Scanning
ESUG
 
PDF
Adobe Illustrator Crack Full Download (Latest Version 2025) Pre-Activated
imang66g
 
PDF
Infrastructure planning and resilience - Keith Hastings.pptx.pdf
Safe Software
 
PPTX
SAP Public Cloud PPT , SAP PPT, Public Cloud PPT
sonawanekundan2024
 
PPTX
ChessBase 18.02 Crack + Serial Key Free Download
cracked shares
 
PPTX
Presentation about variables and constant.pptx
kr2589474
 
PPTX
Farrell__10e_ch04_PowerPoint.pptx Programming Logic and Design slides
bashnahara11
 
PDF
Salesforce Pricing Update 2025: Impact, Strategy & Smart Cost Optimization wi...
GetOnCRM Solutions
 
PDF
ChatPharo: an Open Architecture for Understanding How to Talk Live to LLMs
ESUG
 
PDF
Salesforce Implementation Services Provider.pdf
VALiNTRY360
 
PPTX
Contractor Management Platform and Software Solution for Compliance
SHEQ Network Limited
 
PDF
Malaysia’s e-Invoice System: A Complete Guide for Businesses
Matiyas Solutions
 
Employee salary prediction using Machine learning Project template.ppt
bhanuk27082004
 
10 posting ideas for community engagement with AI prompts
Pankaj Taneja
 
Cutting Optimization Pro 5.18.2 Crack With Free Download
cracked shares
 
Chess King 25.0.0.2500 With Crack Full Free Download
cracked shares
 
Balancing Resource Capacity and Workloads with OnePlan – Avoid Overloading Te...
OnePlan Solutions
 
slidesgo-unlocking-the-code-the-dynamic-dance-of-variables-and-constants-2024...
kr2589474
 
Download iTop VPN Free 6.1.0.5882 Crack Full Activated Pre Latest 2025
imang66g
 
AI Software Engineering based on Multi-view Modeling and Engineering Patterns
Hironori Washizaki
 
Enhancing Security in VAST: Towards Static Vulnerability Scanning
ESUG
 
Adobe Illustrator Crack Full Download (Latest Version 2025) Pre-Activated
imang66g
 
Infrastructure planning and resilience - Keith Hastings.pptx.pdf
Safe Software
 
SAP Public Cloud PPT , SAP PPT, Public Cloud PPT
sonawanekundan2024
 
ChessBase 18.02 Crack + Serial Key Free Download
cracked shares
 
Presentation about variables and constant.pptx
kr2589474
 
Farrell__10e_ch04_PowerPoint.pptx Programming Logic and Design slides
bashnahara11
 
Salesforce Pricing Update 2025: Impact, Strategy & Smart Cost Optimization wi...
GetOnCRM Solutions
 
ChatPharo: an Open Architecture for Understanding How to Talk Live to LLMs
ESUG
 
Salesforce Implementation Services Provider.pdf
VALiNTRY360
 
Contractor Management Platform and Software Solution for Compliance
SHEQ Network Limited
 
Malaysia’s e-Invoice System: A Complete Guide for Businesses
Matiyas Solutions
 

A Snapshot of API Design Trends In 2019