you are here


REST API Multiple-Request Chaining

One of the challenges we have today with truly hypermedia based APIs is the need to make several separate HTTP calls to access and step through the API. REST API Multiple-Request Chaining is a brainstorming spec to allow us to instead thread or chain API calls together in a single HTTP Request, letting the client […]

You Need a REAL API Interface

I have to admit, I’m having a great time at API World. From hearing different talks and ideas, to the launch of Swagger Hub, to seeing all of the new technology surrounding APIs and integration. But as everyone rushes towards building APIs, and looks for shortcuts, it’s also important to remember that there are no […]

API Meetup Groups

The following is a work in progress. Please contact me if you know of a good group to add to this list. Thanks! Address  --Search By City--Los Angeles, CASan Francisco, CADenver, CoWashington, DCMiami, FLTampa, FLChicago, ILBoston, MABaltimore, MDDetroit, MIMinneapolis, MNNew York, NYNashville, TNAustin, TXDallas, TXHouston, TXAmerican Fork, UTSeattle, WA Radius 1 mi5 mi10 mi25 mi50 […]

Code on Demand… Today.

“Sometimes I feel that ‘over-engineering’ is this disease that is running wild in our industry and as architects we need to be on the constant watch to quickly eliminate it whenever encountered.” – Drew Jaegle, in response to API Best Practices: The Wrap Up Last week Jason Harmon asked me if there were any good […]

What the Heck are CURIEs?!

Short Answer: CURIEs provide a shortcut or template for linking to API documentation within a HAL based API response. Long Answer: CURIEs were implemented into HAL to let users identify/ group links while providing a URL template to shorten the linking process and reduce data transfer.  This was done to make the API more discoverable, although this concept […]

CPHL – the Cross Platform Hypertext Language

CPHL is an idea that I’m currently playing with as I’m exploring how to make API clients more dynamic, and less reliant on hard coded actions (currently the way most clients/ SDKs are written). The thought behind CPHL is to create an action based linking system (rather than resource based) that is capable of representing different […]

Code-on-Demand… Like it’s 1985

As promised, I wanted to take a few minutes to share my opinion the only optional REST constraint, Code-on-Demand. Being optional, and perhaps seemingly impractical it’s no surprise that most RESTful APIs choose to bypass this constraint.  Especially as REST is used tremendously for web applications, meaning that it would need to be compatible with any […]

More Objections to HATEOAS

This week on the MuleSoft blog I took a look at Hypermedia, HATEOAS, and common arguments for and against Hypermedia.  However, the list of objections is really too long to summarize in a quick, introductory post.  Shortly after writing my hypermedia post for MuleSoft I came across the post “RESTisential Crisis over Hypermedia APIs” by […]

API Resources

API Specs | Frameworks | API Portals/ Managers (FREE) | API Portals/ Managers (PAID) | SDK Generators | Tutorials/ Resources | Videos | Books | Training Courses | Fun API Specs View a snapshot of spec strengths and weaknesses with the API Spec Comparison Tool API Blueprint API Blueprint provides a markdown format for describing […]

API Spec Comparison Tool

Last updated November 4, 2016 API Blueprint   RAML   Swagger   IO Docs   Mashape   WADL   Attribute API Blueprint RAML Swagger IO Docs Mashape WADL Usability Spec N/A Website Language Support N/A Ease of Getting Started Ease of Spec Maintenance Spec Driven API Design First Visual API Designer N/A N/A Offline IDE […]

Previous Posts