Posted on 07-25-2014
I'm preparing for my hypermedia panel with Mike Amundsen (@mamund), Mike Kelly (@mikekelly85), Steve Klabnik (@steveklabnik), Kevin Swiber (@kevinswiber), Jørn Wildt (@JornWildt), and Markus Lanthaler (@MarkusLanthaler), at API Craft Detroit next week. I wanted to go into the panel with a snapshot, and at least a minimal understanding of each of the panelists. This is kind of an all-star panel of hypermedia experts, so I need to at least bump up my understanding of what they are contributing to the API space, and who they are, beyond what I know from my own interactions with these API leaders.
As I do with all of my research, I wanted to share my work with you, my reader. Next up is Mike Kelly. I'm been tracking on Mike's work around HAL for a while now, I wrote about Amazon using HAL for their AppStream API, a while back. I'm eager to learn more about HAL, and what it brings to the API design process, and how Mike, and HAL size up against the rest of the panelists, and their offerings.
Here is the outline of my research into Mike's work:
Mike Kelly is a software engineer from the UK. He runs an API consultancy helping companies design and build beautiful APIs that developers love.
Title: Web Engineer at Stateless Consulting
Mission: I like using technology to solve interesting problems.
- Blog- http://stateless.co/
- Blog - http://blog.stateless.co/
- Blog RSS - http://blog.stateless.co/rss
- Twitter- https://twitter.com/mikekelly85
- Github - https://github.com/mikekelly
Mike brings the Hypertext Application Language (HAL) format to the hypermedia discussion. He's been at it since summer of 2011, so he's been a pretty strong advocate in the space for some time, applying his mad skills that are polished at his consultancy Stateless.co. Let's take a quick look at HAL, and what resources I could find to support it.
HAL - Hypertext Application Language
HAL is a simple format that gives a consistent and easy way to hyperlink between resources in your API. Adopting HAL will make your API explorable, and its documentation easily discoverable from within the API itself. In short, it will make your API easier to work with and therefore more attractive to client developers. APIs that adopt HAL can be easily served and consumed using open source libraries available for most major programming languages. It's also simple enough that you can just deal with it as you would any other JSON.
- Definition - http://stateless.co/hal_specification.html
- APIs - https://github.com/mikekelly/hal_specification/wiki/APIs
- Explorer - http://haltalk.herokuapp.com/explorer/browser.html#/
- Client Libraries - https://github.com/mikekelly/hal_specification/wiki/Libraries
- Google Group - https://groups.google.com/forum/#!forum/hal-discuss
- Hacker News - https://news.ycombinator.com/item?id=4950986
- Quota - http://www.quora.com/REST-software-architectural-style/JSON-+-Hypermedia-Using-HAL-in-Production
I'm not posting all of this information just so I can share my research, it is also because Mike is a leader in the API space, and I want to better understand the role he plays, while also helping you understand along the way. While I learned a lot through this process, I will also use it as a reference for my panel at API Craft, and for other stories I write in the future.
I've already added HAL as a tools in my hypermedia API research. I could spend days going through this research, but I also have four other hypermedia API experts to profile, so I'm going to move on to the others, and come back to my profile of Mike Kelly in the future to continue my hypermedia education.
comments powered by Disqus
Winning in the API Economy
|Download as PDF|
Latest Blog Posts
- Where Do We Start With APIs At The University of Oklahoma?
- What I Would Look For When Hiring a Modern API Developer?
- The U.S. International Trade Commission Includes APIs In Latest Report
- Thank You @3Scale For Investing In The Community With @APIStrat
- Introducing API.Report, A Community API News Site
- Extract Knowledge From Audio And Video Using The Clarify API
- My API 101 Workshop At @APIStrat In Chicago Next Week
- Some Advice For The Enterprise When Beginning Your API Journey
- Machine Readable API Definition Format Swagger Matures to 2.0
- How Do We Continue Moving Green Button Data And APIs Forward?
- Beyond Public APIs In Government: Internal Access to Resources
- Can You Show Me The ROI On All Of This API Stuff Before We Commit
- In The Future APIs Will Be Default For All Cities
- No Public APIs Are Not Going Away Just Cause A Few BigCos Fumble At It
- Internal API Search Engine For Everyone At Your Company (Not Just Developers)
- If You Need Assistance With Your Healthcare API Strategy I Have The Person
- Explaining APIs To Senior Leadership: Access To Company Resources Without The IT Hassle
- A Conversation With @ijroth, @dorkitude, @antonyfalco, and @medjawii In The Next Generation API Stack Panel @APIStrat
- API Evangelist Thoughts On The Right To An API Key And Algorithmic Organizing
- Explaining APIs To Your Senior Leadership
- An API Evangelism Strategy To Map The Global Family Tree
- Thank You For Your API Evangelist Blog(s)
- Video From The Hypermedia Panel At API-Craft In Detroit Last Month
- Please Open Source Your API Before Shutting It Down
- Explaining My Work Around APIs In Higher Education To Institutions