Posted on 11-20-2013
With the growing number of hypermedia API deployments, hypermedia haters© are going to lose a major argument, that hypermedia is just an academic exercise and will never work in the wild. ;-)
The latest hypermedia API I was told about in the wild(thanks @johnmusser), is from Amazon Web Services with the recent AppStream API--"a flexible, low-latency service that lets you stream resource intensive applications and games from the cloud".
The AWS AppStream API is an API that uses Hypertext Application Language (HAL), a consistent and easy way to hyperlink between API resources, created by Mike Kelly(@mikekelly85) of Stateless.co. When HAL is used, with each API request, you get a wealth of links that allow you to programmatically explore the functionality of an API.
For example, you can explore the JSON returned in each response from the application API endpoint, about a specific app you are streaming including using the services, you will find links to determine application status, show information on current session and many more.
Normally with APIs, developers have to explore each API endpoint, and read through documentation to understand the different actions that can be taken against an API. With HAL, API owners can craft links that provide meaningful actions that can be discovered and implemented by developers along the way, teaching them about what is possible with each API call.
Hypermedia goes a long way in extending business rules to developers, not just directing them to what next steps may be taken at each API request, but really save them a lot of homework on how your API business model works, and how to best build an application around an API.
There are other hypermedia APIs in the wild, including the very important Public Media Platform (PMP), but the numbers are still low. I will keep finding quality hypermedia solutions in the wild and sharing them with you as I find.
comments powered by Disqus
Winning in the API Economy
|Download as PDF|
Latest Blog Posts
- Viewbook Uses Flickr API Design When Designing Their Own
- Expanding An API Designers Horizon Using Apiary
- What Version Of The API Economy Are You Investing In?
- I Am Up To 34 APIs Out Of The Netherlands
- Hello World Product API With Blueprint, RAML And Swagger
- The New Github Developer Program and Integrations Page
- I Have A Valuable API Resource, What Now?
- A Better Understanding Of Government APIs And Their Consumers Before Considering Charging For Use
- So You Wanna Do a Spreadsheet or Database To API Startup
- Jumpstarting the Automobile API Conversation With Carvoyant