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
310
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
280
APIStrat 2016 | OpenAPI Trek: Beyond API Documentation (Arnaud Lauret)
apistrat
5
220
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
99
APIStrat 2016 | Effortless microservices in production with Kubernetes (Ken Wronkiewicz)
apistrat
0
130
Song by Tony Blank
apistrat
0
150
API Lifecycle Manager by Steve Fonseca
apistrat
2
220
APIs In The Enterprise: How Walgreens Formed It's Digital Business by Drew Schweinfurth
apistrat
1
360
Developers Are Difficult by Andrew Noonan
apistrat
0
120
Other Decks in Technology
See All in Technology
PHP ユーザのための OpenTelemetry 入門 / phpcon2024-opentelemetry
shin1x1
3
1.2k
AWS re:Invent 2024で発表された コードを書く開発者向け機能について
maruto
0
200
祝!Iceberg祭開幕!re:Invent 2024データレイク関連アップデート10分総ざらい
kniino
3
330
[Ruby] Develop a Morse Code Learning Gem & Beep from Strings
oguressive
1
170
OpenAIの蒸留機能(Model Distillation)を使用して運用中のLLMのコストを削減する取り組み
pharma_x_tech
4
570
あの日俺達が夢見たサーバレスアーキテクチャ/the-serverless-architecture-we-dreamed-of
tomoki10
0
500
新機能VPCリソースエンドポイント機能検証から得られた考察
duelist2020jp
0
230
alecthomas/kong はいいぞ / kamakura.go#7
fujiwara3
1
300
10分で学ぶKubernetesコンテナセキュリティ/10min-k8s-container-sec
mochizuki875
3
360
どちらを使う?GitHub or Azure DevOps Ver. 24H2
kkamegawa
0
950
Wantedly での Datadog 活用事例
bgpat
1
550
大幅アップデートされたRagas v0.2をキャッチアップ
os1ma
2
540
Featured
See All Featured
[RailsConf 2023] Rails as a piece of cake
palkan
53
5k
The Cost Of JavaScript in 2023
addyosmani
45
7k
jQuery: Nuts, Bolts and Bling
dougneiner
61
7.5k
Learning to Love Humans: Emotional Interface Design
aarron
273
40k
Practical Orchestrator
shlominoach
186
10k
Testing 201, or: Great Expectations
jmmastey
40
7.1k
BBQ
matthewcrist
85
9.4k
Art, The Web, and Tiny UX
lynnandtonic
298
20k
Mobile First: as difficult as doing things right
swwweet
222
9k
Bootstrapping a Software Product
garrettdimon
PRO
305
110k
Gamification - CAS2011
davidbonilla
80
5.1k
Git: the NoSQL Database
bkeepers
PRO
427
64k
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