Building RESTful Graph APIs that lasts
summary
Builds an unversioned, long-lived REST graph by using json-ld to decouple property names from meaning and Hydra to expose links, collections, paging and machine-readable forms so generic clients can discover entry points and perform actions like a purchase. Authentication uses OAuth/OpenID Connect. Microservices publish their view of types and operations to an API gateway that performs automatic schema overlay for canary, preview and live routing. Implementation uses OpenRasta to generate hypermedia and a generic Hydra console; the system ships in production for UK property data and is working.
AI-written summary · about
chapters (9)
- 0:00Intro
- 2:20JSONLD
- 2:35Context File
- 6:58Relationships
- 8:25Hydra
- 9:50OAuth
- 10:53Collections
- 13:25Operations
- 15:47API Gateway
related talks
01h 00mThe Secrets to Smart, Flexible, Self Describing API
01h 02mHypermedia and the Rest of REST
36mThe Graph of Everything - Federated Architecture for Any API Service
58mHypermedia APIs and the Future of AI Agentic Systems
34mFeed the links, tuples' a bag – Intro to Linked Data APIs
39mapi-platform
18mGraphQL, gRPC and REST, Oh My! A Method for Unified API Design
20mYour Http-based API is not restful