Resources
This page summarizes different resources around Hypermedia and some of its formats. The sections are public APIs currently using Hypermedia and text and video material about the topic for those interested.
Public APIs using Hypermedia
The following services use Hypermedia for the public APIs. On top of these, there may be many more using it internal or for private (or paid) APIs which are not publicly documented.
- Github - It uses basic level 0 hyperlinks.
- Amazon API Gateway - It uses HAL.
- Netflix's Genie - It uses HAL.
- Paypal - It uses a custom Hypermedia format.
- Spotify - It uses basic level 0 hyperlinks.
- Open Banking - It uses JSON:API.
- Platform of Trust - It does not specify any concrete format.
- Elastic Path - It uses custom Level 1 format.
- Family Search - It uses its own format GEDCOM X.
If you want to add another item to the list, submit a PR.
Useful resouces
These are Python or Hypermedia-specific resources to get into the topic and delve deeper. Not all of the resources include Python code, that being said, the reader may benefit even if examples are in other languages.
Video
Only english-speaking videos from "reviewed sources" are added, that is, videos published at conferences or by official organizations. This is to ensure a minimum quality for the content. There are more videos availables online as well.
To keep the list clean from too outdated resources, only resources from 2012 or later are included.
- 2023 - The Secrets to Smart, Flexible, Self Describing API - Michael Carducci - Great International Developer Summit
- 2023 - Ditch heavy JS and KISS your frontend again with HTML over-the-wire - Alex Finnarn - Stir Trek
- 2023 - Back to the Future of Hypermedia in Python - Mario Munoz - North Bay Python
- 2023 - Back to the Future of Hypermedia in Django with - Mario Munoz - DjangoCon US
- 2022 - Return To Hypermedia: Solving Javascript Fatigue Using Fundamental Web Architecture - Carson Gross - ChariotSolutions
- 2022 - How to JSON:API Quickly and Easily in Laravel - Matt Stauffer - Laracon
- 2021 - Introduction to HATEOAS with Ketting - Evert Pot - APIdays NewYork
- 2021 - RESTful API the HATEOAS Way - Ron Garlit - SWFL Coders
- 2021 - Evolving Hypermedia - Tomasz Pluskiewicz - Nordic APIs
- 2021 - REST, HATEOAS & Django - It's OK to not use JSON... or Javascript - Carson Gross - DjangoCon US
- 2021 - Elementary Full stack Development with Hypermedia and Java 21 - Patrik Duditš - Devoxx
- 2021 - Hypermedia without the hype - Tim Lytle - Comference
- 2021 - JSON, JSON Schema, JSON-LD - Jakub Klímek - NPRG036 Data Formats
- 2021 - Building Futureproof APIs with Spring HATEOAS - Greg Turnquist - JCon
- 2021 - Why JSON-LD and what is it? - Samuel Rozé - API Platform Con
- 2020 - Evolving architecture with DDD and hypermedia - Einar Høst - Domain-Driven Design Europe
- 2020 - Discoverable Hypermedia-Driven RESTful Web Services in Clojure - Daniel Zurawski - London Clojurians
- 2020 - Building Flexible APIs with Spring HATEOAS - Greg Turnquist - Spring One
- 2019 - Building RESTful Graph APIs that lasts - Sebastian Lambla - APIdays Barcelona
- 2019 - Testing APIs the Hypermedia way - Tomasz Pluskiewicz - APIdays Barcelona
- 2019 - Hail Hydra: The Future of Web APIs is Here - Devdutt Shenoi - FOSSMeet
- 2019 - How to get along with HATEOAS without letting the bad guys steal your lunch? - Steve Poole, Graham Charters - Voxxed Days Luxembourg
- 2019 - Bringing Hypermedia to the Masses - Tomasz Pluskiewicz - Nordic APIs Platform Summit
- 2019 - How to get along with HATEOAS without letting the bad guys steal your lunch? - Steve Poole & Graham Charters - Devoxx
- 2019 - Spring HATEOAS - Hypermedia APIs with Spring - Oliver Drotbohm, Greg Turnquist - SpringOne Platform
- 2018 - Love to HATEOAS: Hypermedia for Fun and Profit - Gabriel Sullice - Decoupled Drupal Days
- 2018 - Creating 3rd generation Web APIs using Hydra and Hydrus - Akshay Dahiya - PyCon India
- 2018 - Documenting Hypermedia APIs - Nick Bradley - API the Docs London
- 2018 - The JSON API Spec - Marco Otte-Witte - API Conference
- 2017 - Hypermedia APIs and HATEOAS - Volodymyr Tsukur - Wix Engineering Meetup
- 2017 - RESTful Hypermedia APIs - Kai Tödter - Jax London
- 2018 - Real World REST and Hands-On Hypermedia - Dylan Beattie - DevTernity Conference
- 2017 - Real World REST and Hands-On Hypermedia - Dylan Beattie - DotNext
- 2017 - Full Stack REST - Jimmy Bogard - DevReach Conference
- 2016 - Get HATEOAS and Hypermedia right with Spring - Eugene Paraschiv - Sping I/O
- 2016 - Developing a developer-friendly hypermedia API with django-rest-framework and behave - Joost Cassee - PyCon Sette
- 2015 - Making Sense of Hypermedia APIs - Hype or Reality - Laura Heritage - Akana Webinar
- 2015 - Using Hypermedia APIs to Drive Interactive Mobile Applications - Benjamin Greenberg - Full Stack Toronto Conf
- 2016 - The Rest of ReST - Dylan Beattie - NDC Conference
- 2015 - Hypermedia APIs - The Rest of REST - Chris Marinos - SEM JS
- 2015 - SmartData Webinar JSON LD - Brian Sletten - DataVeristy
- 2015 - Hypermedia The Good, the Bad and the Ugly - Mike Stowe - Devnexus
- 2014 - Cutting-edge APIs using hypermedia at BSkyB - Adriana Vasiu - EuroPython
- 2014 - Hypermedia - The rest of REST - Steven Cummings - Cerner DevCon
- 2014 - On the Edge of Hypermedia - Keith Casey - Midwest.io
- 2014 - Hypermedia: Taking your API to the next level - Unknown - NERD Summit
- 2012 - Designing Hypermedia APIs - Steve Klabnik - Rails Conf
- 2012 - Designing Hypermedia APIs - Steve Klabnik - TwilioCon
If you want to add another item to the list, submit a PR.
Blogs and Articles
Here there are blog posts and articles from different sources, some organizations and some individuals. The length varies but each has its own value.
- 2024-01-30 - Pradeep Loganathan - HATEOAS
- 2023-11-09 - Antonio W. Lagnada - ReST HATEOAS Best Practices
- 2023-11-04 - Lokesh Gupta - HATEOAS Driven REST APIs
- 2023-03-26 - Mahul Mohan - REST API Design: Advanced HATEOAS Implementation and Use Cases
- 2022-10-02 - GeeksforGeeks - HATEOAS and Why It’s Needed in RESTful API?
- 2021-04-20 - Luca Christen - Using HATEOAS with REST APIs
- 2019-06-01 - Tomasz Pluskiewicz - Testing APIs Hypermedia-style
- 2018-05-30 - Jason Desrosiers - The Hypermedia Maturity Model
- 2018-04-11 - Jason Desrosiers - Decoupling the Client and Server with Hypermedia
- 2018-03-21 - Jason Desrosiers - Turning Up The Good On REST APIs
- 2017-01-31 - Bill Doerrfeld - Designing a True REST State Machine
- 2016-01-19 - Kristopher Sandoval - How to Improve API Experience Using Hypermedia
- 2014-03-11 - Kevin Sookocheff - On choosing a hypermedia type for your API - HAL, JSON-LD, Collection+JSON, SIREN, Oh My!
- 2008-10-20 - Roy T. Fielding - REST APIs must be hypertext-driven
If you want to add another item to the list, submit a PR.
Books
There are not too many books which a strong focus on hypermedia or HATEOAS, however the following are complementary and in-line with designing discoverable and evolvable REST APIs.
- 2021 - Building Microservices - Sam Newman - O'Reilly
- 2017 - RESTful Web Clients - Mike Amundsen - O'Reilly
- 2016 - RESTful API Design: Best Practices in API Design with REST - Matthias Biehl - API-University Press
- 2013 - RESTful Web APIs - Leonard Richardson, Mike Amundsen, Sam Ruby - O'Reilly
- 2012 - Designing Hypermedia APIs - Steve Klabnik - Self Published
- 2011 - Building Hypermedia APIs With HTML5 and Node - Mike Amundsen - O'Reilly
- 2010 - REST in Practice: Hypermedia and Systems Architecture - Jim Webber, Savas Parastatidis, Ian Robinson - O'Reilly
If you want to add another item to the list, submit a PR.