Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
Hypermedia APIs for the Enterprise
Search
API Strategy & Practice Conference
March 05, 2013
Technology
1
300
Hypermedia APIs for the Enterprise
by Jon Moore @ Apistrat NYC (Feb. 2013)
API Strategy & Practice Conference
March 05, 2013
Tweet
Share
More Decks by API Strategy & Practice Conference
See All by API Strategy & Practice Conference
APIStrat 2016 | The end of polling: why and how to transform a REST API into a Data Streaming API (Audrey Neveu)
apistrat
12
270
APIStrat 2016 | OpenAPI Trek: Beyond API Documentation (Arnaud Lauret)
apistrat
5
210
APIStrat 2016 | Flying Dreams: Real-Time Communication from the Edge of Space (Jonathan Barton, Neha Abrol)
apistrat
1
120
APIStrat 2016 | On-prem support? That was so 1982 (Charlie Ozinga)
apistrat
0
86
APIStrat 2016 | Effortless microservices in production with Kubernetes (Ken Wronkiewicz)
apistrat
0
120
Song by Tony Blank
apistrat
0
140
API Lifecycle Manager by Steve Fonseca
apistrat
2
200
APIs In The Enterprise: How Walgreens Formed It's Digital Business by Drew Schweinfurth
apistrat
1
350
Developers Are Difficult by Andrew Noonan
apistrat
0
120
Other Decks in Technology
See All in Technology
コンパウンドスタートアップのためのスケーラブルでセキュアなInfrastructure as Codeパイプラインを考える / Scalable and Secure Infrastructure as Code Pipeline for a Compound Startup
yuyatakeyama
4
4.7k
DevOpsDays History and my DevOps story
kawaguti
PRO
9
2.4k
Janus
bkuhlmann
1
490
Reducing Cross-Zone Egress at Spotify with Custom gRPC Load Balancing Recap
koh_naga
0
190
プラットフォームってつくることより計測することが重要なんじゃないかという話 / Platform Engineering Meetup #8
taishin
1
340
ゼロから始めるVue.jsコミュニティ貢献 / first-vuejs-community-contribution-link-and-motivation
lmi
1
110
アクセス制御にまつわる改善 / Improving access control
itkq
0
510
非同期推論システムによるコスト削減と信頼性向上
koki_nishihara
0
130
検証を通して見えてきたTiDBの性能特性
lycorptech_jp
PRO
6
3.7k
JSON攻略法.pdf
miyakemito
8
4.8k
Meta Quest 3 で動く桜マシマシ WebXR アプリを IBM Cloud Code Engine と Babylon.js で作った話
1ftseabass
PRO
0
120
複雑な構成要素を持つUIとの向き合い方 〜新・支出グラフでの実例〜 / B43 TECH TALK
nakamuuu
0
140
Featured
See All Featured
Why Our Code Smells
bkeepers
PRO
331
56k
How GitHub Uses GitHub to Build GitHub
holman
468
290k
The Language of Interfaces
destraynor
151
23k
A designer walks into a library…
pauljervisheath
200
23k
Bootstrapping a Software Product
garrettdimon
PRO
302
110k
Art, The Web, and Tiny UX
lynnandtonic
289
19k
WebSockets: Embracing the real-time Web
robhawkes
59
7k
個人開発の失敗を避けるイケてる考え方 / tips for indie hackers
panda_program
60
14k
Code Reviewing Like a Champion
maltzj
514
39k
Build The Right Thing And Hit Your Dates
maggiecrowley
24
2k
Into the Great Unknown - MozCon
thekraken
10
990
Building a Scalable Design System with Sketch
lauravandoore
456
32k
Transcript
Hypermedia APIs for the Enterprise Jon Moore (@jon_moore)
Technical Fellow, Chief Engineer
How do you scale a development team?
How do you scale a development team?
Amdahl’s Law hDp://en.wikipedia.org/wiki/File:Amdahl_march_13_2008.jpg (Pkivolowitz at en.wikipedia)
Need to operate independently…
Conway’s Law Melvin E. Conway, “How do commiDees invent?”,
Datama%on, 14(4):28—31, April 1968.
Will tend to build their own widgets…
Loose coupling hDp://www.flickr.com/photos/usnaYonalarchives/3695598804/ (public domain)
Essen@al Components of an API DOMAIN MODEL OPERATIONS &
WORKFLOW INVOCATION MECHANICS
Domain Models TVEpisode TVSeason TVSeries part-‐of-‐season
part-‐of-‐series part-‐of-‐series “The Simpsons” name
Workflow: Client Applica@on State START Search Results
Cart Item Detail Shipping & Billing Payment ConfirmaYon
Mechanics for Transi@ons POST /api/widgets HTTP/1.1 Host: www.example.com Content-Type:
application/json Content-Length: 13 {‘foo’:‘bar’} method URI formaeng of request body
Evolvability: “Must Ignore” hDp://www.flickr.com/photos/johnsnape/4258191545/ by John Snape (CC BY
2.0)
Evolving Models TVEpisode TVSeason TVSeries part-‐of-‐season
part-‐of-‐series part-‐of-‐series “The Simpsons” name Video associated-‐media
Evolving Workflow START Search Results Cart
Item Detail Shipping & Billing Payment ConfirmaYon update qty edit Gii Message submit
What is this mythical content type?
HTML5 Microdata (schema.org) <div itemscope=“1” itemtype=“http://schema.org/TVSeries”> <span itemprop=“name”>The Simpsons</span>
</div>
Link Rela@ons: IoC for Workflow author next prev first
last edit index item search http://example.com/my-rel
Links and Forms: Request Recipes hDp://www.flickr.com/photos/naYonalarchives/4157825846/ (UK NaYonal Archives,
public domain, c. 1624)
• SemanYc markup • RDFa: hDp://www.w3.org/TR/xhtml-‐rdfa-‐primer/ • JSON-‐LD:
hDp://json-‐ld.org/ • Hypermedia controls • CollecYon+JSON: hDp://amundsen.com/media-‐types/collecYon/ • HAL: hDp://stateless.co/hal_specificaYon.html • Siren: hDps://github.com/kevinswiber/siren • Link relaYons • IANA registry: hDp://www.iana.org/assignments/link-‐relaYons/link-‐relaYons.xml • Link header: hDp://tools.ieq.org/html/rfc5988 Related Work
• Enterprises ≈ collecYon of ADs • Independent Evolvability
is the key to scale – Domain model (“where am I?”) – Workflow (“what can I do next?”) – Mechanics (“how do I do it?”) • HTML5 offers an exisYng, pracYcal opYon for building hypermedia APIs • Efforts underway to duplicate this for JSON Conclusions