Posted on 06-05-2014
There are numerous reasons for API designers to follow hypermedia patterns when crafting their internal, partner or publicly available APIs. One of the most fundamental reasons for offering hypermedia is to help developers understand what to do next, once receiving a response from your API.
Hypermedia APIs mimic the default characteristics of the web, and how you always know what do next with a web page, because there are many available links either in the form of navigation, in the body or footer. Reflecting this behavior, each hypermedia API resources comes with a set of related links giving developers clear actions to take once the response is received.
It can be easy to get lost in the numerous hypermedia debates online, not quite understanding all of the benefits of this fast growing API design pattern, but one clear reason is to help developers understand what to do next. Without clear instructions, developers can make obvious mistakes, misuse or misrepresent API resources, and be out of alignment with your own business goals in providing the API resource in the first place.
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