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
- Reworking My API 101 Content: Consuming APIs
- I Need Help To Make Sure The Dept. of Agriculture Leads With APIs In Their Parks and Recreation RFP
- What Is The Biggest Challenge For Fraud Detection API SiftScience?
- Reworking My API 101 Content: Providing APIs
- What I Spent Ada Lovelace Day Working On
- An Outside-In Approach To Jumpstarting An API Effort At The University of Oklahoma
- Exposing Dictionaries From My API Collections
- Launching 25 APIs To Assemble A Single Poem For Each Day
- Exploring The Possibilities of Being An API Broker
- The Publicly Available Private Target APIs