One topic that drives a lot of pageviews and discussions on a blog post, is sunsetting or deprecation of an API. I’ve written a lot about this with APIs Are Forever, Wait No...They Can Go Away at Any Time!!! and Building Your Business Around Google or Any Other APIs.
I wanted to write another post on this, in hopes of understanding it a little more and generating discussion, and of course be somewhat of a pageview whore.
When it comes to deprecating an API, from the perspective of the API owner, what can they do to alleviate the pain of the API going away:
- Never Deprecate an API - Support the grandchildren of your current developers, creating an API dynasty.
- Deprecation Policy or SLA - Set expectations with developers through a deprecation policy, and service level agreements (SLA)
From the perspective of an industry or API developer community:
- Develop Industry Standard - If an API is so important, come together and establish an industry wide standard for the space, so anyone can play.
- Develop Unified APIs - Establish a federated or centralized bridge between multiple APIs such as DeltaCloud has done for cloud storage or WindSoc has done for social.
I don’t think we can count on API owners never deprecating an API or always having SLA and depreciation policies, and I’m not sure if API standards or unified APIs will win out. So my suggestion is encouraging API owners to open source their API upon deprecation.
Open sourcing a deprecated API, would allow anyone to step in, and run with the API either taking in a new direction and / or supporting the existing customer base and opportunity. One example of this was when LinkedIn acquired IndexTank, then open-sourced the core technology enabling other companies to step in and support existing API developers and take advantage of the indexing technology.
Even beyond supporting existing API developers, open sourcing a deprecated API would establish an “open” precedent for a technology, and even upon the demise of its parent company, would prevent copyright and patent trolls from buying up legacy companies, only with the goal of stifling innovation.
So consider adding an open-source clause to your API deprecation policy.
|Deprecation, Open source, Service Level Agreement, SLA|
blog comments powered by Disqus
Latest Blog Posts
- Open Data as Defined By the White House
- Lack of Cloud Awareness Impacted Twitters Perspective, Setting Bad Tone for How It Deals With Ecosystem
- The 3 Legs Of An Open API
- The Executives Guide to Power and Retention In An API Driven World
- Three Layers of Open
- API Transparency Report as Essential Building Block
- Government and Vendor Data Access Via My Platform OAuth
- At What Point Should Twitter Be Considered An Essential Service?
- Are We Eliminating The Open From the Internet By Using APIs?
- Making Transparency Reports Standard Operating Procedure