manage your public api like a protocol
DESCRIPTION
As the number of public APIs available to developers skyrockets, developers are increasingly asked to evaluate dozens of API providers based on their market opportunity, ease of integration and stability of service - then choose a winner to integrate with. You can quickly communicate that your company is interested in providing opportunity to developers by managing your API like a protocol. Discover why good versioning practices, incorporating developer input, participating in developer meetups and hackathons, and adopting existing standards whenever possible makes good business sense for both API developers and API providers.TRANSCRIPT
![Page 1: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/1.jpg)
Manage your Public API Like a ProtocolDelyn SimonsVP Developer Platform, Mashery@delynator @mashery #df12 #devzone
![Page 2: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/2.jpg)
What we hear from businesses
“We need to speed up our product development cycle.”
“Our stock price is half what it was 10 years ago.”
“How can we jumpstart innovation throughout the company?”
“My CEO wants us to have an iPad app by the next board meeting.”
“We are having a difficult time recruiting engineers.”
![Page 3: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/3.jpg)
What we hear from developers
• “Documentation and examples. Give me those, keep them up to date and I'm happy.”
• “Version *every* change to your API, and version your docs the same way, so I always know which functionality I'm getting, and what it's really supposed to do.”
• “Keep your documentation up to date and in all reasonable instances provide a fucking library for common languages that has real production-ready code instead of some bullshit an intern wrote in an afternoon for a demo.”
• Credit: YourTrove Hacker News Developer Survey, August 2011
![Page 4: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/4.jpg)
Open APIs: Growth is accelerating
ProgrammableWeb API directory7000 APIs and
Total APIs Over Time
8 years
18 months
9 months
4 months
6 months
![Page 5: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/5.jpg)
Slide Courtesy of ProgrammableWeb
![Page 6: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/6.jpg)
Slide Courtesy of ProgrammableWeb
![Page 7: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/7.jpg)
![Page 8: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/8.jpg)
![Page 9: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/9.jpg)
![Page 10: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/10.jpg)
![Page 11: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/11.jpg)
How did we get here?
![Page 12: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/12.jpg)
![Page 13: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/13.jpg)
Think like a Product Think like a Platform
Device-centric Services-centric
OS Cloud
Hardware Content
Download Stream
Wired Magazine, Dec 2011
![Page 14: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/14.jpg)
Developers change the game
![Page 15: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/15.jpg)
Protocol: Communications
Definition: A system of digital message formats and rules for exchanging those messages in or between computing systems. A protocol definition defines the syntax, semantics, and synchronization of communication.
Examples: HTTP, FTP, TCP/IP, POP3, OAuth, OData, Atom/RSS, PubSubHubBub, OpenSocial
Credit: Internet Engineering Task Force (IETF)
![Page 16: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/16.jpg)
Protocol: Diplomacy
Definition: a set of rules which guides how an activity should be performed and based on the principles of civility. These well-established and time-honored rules have made it easier for nations and people to live and work together.
Examples: Kyoto Protocol, Montreal Protocol, US State Dept. Office of the Chief of Protocol, United Nations Protocol to Prevent, Suppress and Punish Trafficking in Persons.
Credit: International Association of Protocol Consultants and Officers.
![Page 17: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/17.jpg)
The promise of a great API platform
![Page 18: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/18.jpg)
… but unilaterally managed APIs often break the cycle
![Page 19: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/19.jpg)
Manage your API like a ProtocolGenerous Terms of Service
Beautiful, well-maintained Docs/Code Samples
5 minutes > first API call
Developer Products are Products, too
Clear Versioning, Deprecation Policy
![Page 20: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/20.jpg)
![Page 21: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/21.jpg)
Manage your API like a ProtocolGenerous Terms of Service
Beautiful, well-maintained Docs/Code Samples
5 minutes > first API call
Developer Products are Products, too.
Clear Versioning, Deprecation Policy
![Page 22: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/22.jpg)
![Page 23: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/23.jpg)
![Page 24: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/24.jpg)
Manage your API like a Protocol
Generous Terms of Service
Beautiful, well-maintained Docs/Code Samples
5 minutes > first API call
Developer Products are Products, too.
Clear Versioning, Deprecation Policy
![Page 25: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/25.jpg)
![Page 26: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/26.jpg)
![Page 27: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/27.jpg)
![Page 28: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/28.jpg)
Manage your API like a Protocol
Generous Terms of Service
Beautiful, well-maintained Docs/Code Samples
5 minutes > first API call
Developer Products are Products, too.
Clear Versioning, Deprecation Policy
![Page 29: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/29.jpg)
![Page 30: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/30.jpg)
![Page 31: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/31.jpg)
Manage your API like a Protocol
Generous Terms of Service
Beautiful, well-maintained Docs/Code Samples
5 minutes > first API call
Developer Products are Products, too.
Clear Versioning, Deprecation Policy
![Page 32: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/32.jpg)
![Page 33: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/33.jpg)
Manage your API like a ProtocolGenerous Terms of Service
Beautiful, well-maintained Docs/Code Samples
5 minutes > first API call
Release Products You are Proud of
Clear Versioning, Deprecation Policy
![Page 34: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/34.jpg)
Deliver on the promise of a great API platform
![Page 35: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/35.jpg)
Photo Credit: flickr.com/techcrunch
Treat your developers like stakeholders
![Page 36: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/36.jpg)
Thank you!
Your feedback is a gift.
Delyn Simons@delynator, @mashery
#df12 #devzoneSeptember 2012
![Page 37: Manage your Public API Like a Protocol](https://reader036.vdocuments.net/reader036/viewer/2022062614/54708514b4af9f980a8b4768/html5/thumbnails/37.jpg)