Posted on 03-30-2012
I read a post over at Cloud Ave today by Martijn Linssen, Why API’s suck, and what they lack. I'll start by saying, everything he says about APIs, can be true for some APIs, but the post has more to do with the state of tech blogging, than anything to do with APIs.
To Linssen's points:
- First of all, API’s aren’t open - True many APIs use this term, without it being true. But those of in the industry who get it, call these "public" APIs and have stopped using the term "open". Open has been used by a few bad marketing seeds, and perpetuated by the blogosphere.
- Second of all, API’s are for free, mostly, and no uptime is guaranteed - What? Really? Maybe the 10 you've tried don't, but many of the APIs I depend on do. Just to name a few: Google Maps, WebServius, Datasift, Zencoder, Amazon EC2, Amazon S3.
- Third, API’s are badly documented, if any - Sure this can be a problem, and is something everyone is working on. This doesn't point to APIs sucking, more the documentation. Can you point me to the documentation you’ve maintained? Its’ not as easy as it looks. And there are plenty of shining examples of how do you do it right.
Ok those are your points? And you went to ProgrammableWeb and looked at 10 APIs? And you came to the conclusion all APIs suck? I've spent hundreds of hours looking through ALL of the APIs in the ProgrammableWeb directory, and yes there is a lot of shit in there. But there are some really amazing examples of the API vision, that you seem to be bothered by.
Have you hacked on Twilio? Twilio rocks! Have you used Stripe? Seen the forwarding thinking e-commerce APIs ElasticPath is working on? Have you hacked on any of the 97+ Google APIs lately? They have come a really long way in pulling together their interfaces, standardizing documentation, making legal easier to use, and standardizing what is free and what is billing.
Linssen seems caught up on the fact that all APIs are some sort of social bullshit. I counter with the fact that the last 5 years of Internet growth has been build on the back of Amazon Web Services, via APIs. When I started using both EC2 and S3, it was all APIs, there were no interfaces. I’ve deployed, scaled and supported global infrastructure with millions of dollars running through those APIs, personally.
My recommendation to Linssen is he spend more time hacking on APIs, and look at the playing field a little more before you professionally blog on the subject. But that brings me back to my title, and the fact that his blog post is about page views, and not about APIs, which represents the state of tech blogosphere and not APIs.
I just went over to Techmeme and look at the top 10 stories, and I decided that all tech bloggers suck and I'll stop reading tech blogs all together. Actually no..I'll keep doing what I do with all tech blogs, evaluate them one by one and unsubscribe when they stop offering value. Much like you should do with APIs.
comments powered by Disqus
Winning in the API Economy
|Download as PDF|
Latest Blog Posts
- Will You Add Me To API Evangelist And How To Spot The Cool Kids
- When I Remix APIs Using Swagger How Do I Deal With Authentication Across Multiple APIs
- It Takes A Team Of Evangelists To Raise An API
- Support For Only Two Creative Commons Licenses In The API Commons
- Machine Readable Terms of Service Didn't Read Applied To APIs Via APIs.json
- API Deployment For Non-Developers Using Zapier, Google Docs, and APISpark
- State of Hypermedia Today @ API Craft In Detroit
- Need A Formal API Standard For Your Government Agency? Fork 18Fs, And Make It Your Own!
- CORS Makes Your API Portable And Remix-able
- Chief Data Officer Needs To Make The Department Of Commerce Developer Portal The Center Of API Economy
- An API Definition As The Truth In The API Contract
- Look At Existing APIs In The Space Before Designing Your Own
- Libraries Hacked: UK Library API, Data And Technology Hacks
- Financial Data Aggregator Yodlee Looking For A Director of Developer Evangelism
- AutoDevBot Open Sources Their API Monitor
- Low Hanging Fruit For API Discovery In The Federal Government
- Looking At 77 Federal Government API Developer Portals And 190 APIs
- Applying APIs.json To API Discovery In The Federal Government
- The Power In API Discovery For APIs.json Will Be In The API URL Type
- Fixing The Machine Readability in API Commons
- Evolving How We Approach The API Lifecycle With APIMatic
- APIs Can Open Up Your Company To Outside Ideas
- APIs Are Often Just A Facade That Is Covering Up The Legacy View Of World
- A Mobile Developer Toolkit With The University Of Michigan APIs
- Kicking Off Image Manipulation API Work