Posted on 03-05-2013
I’m a little behind in working through my list of new APIs to review. So I’m spending about 3 hours each day going through my list of new APIs accumulated from ProgrammableWeb, Tweets, Bookmarks, Google Alerts and other ways I have for discovering new APIs.
After looking through a couple hundred APIs, I wanted to share some things that stand out, and make me feel someone really doesn't give a shit when they hit publish on their API:
- Your entire developer area is a PDF
- Really long, incoherent URL for dev area
- Dev area is just a page in your help directory
- You put google ads on every page of your API documentation
- No communication, support or contact information at all
- Sign up form that pops up in my face as soon as page loads
- Require an NDA before I register
These are just a handful of things that make me give an API a C or D grade, which means you probably aren’t on my radar. But then again if you don't have active blog or twitter or developers aren't talking about you, your API won't register on the radar even with a B grade.
After looking through hundreds of APIs I leave with the same feeling: that there tons of good ideas out there, but 80% of them are just executed very poorly.
comments powered by Disqus
Winning in the API Economy
|Download as PDF|
Latest Blog Posts
- With Number Of APIs Continuing To Grow Account Automation Will Be Key
- History Of APIs: NOAA APIs Have Been RESTful For Over 20 Years
- Understanding More About The Web Communications Platform Respoke
- Swagger Definition Driven Sandbox And Simulation Data Templates For APIs
- Swagger API Definition Mapper
- Moving Beyond Just The PDF With A Single Page Report (SPR)
- Join Me For APIDays Berlin And APIStrat Europe This April 24th-25th 2015
- A Market For API Developer Credits
- Where Do Developers Get Idea That APIs Should Never Go Away?
- The Context.io API And Thinking Out Of The Box When Crafting APIs