Kin Lane

API Evangelist

Building the Enterprise App Factory

Intel Workshops

Apps World - February, 2013

APIs Are Just the Beginning

Solve end user problems with efficient delivery of apps!

Enterprise App Factory Stages

• Planning & Design
• Building Blocks
• Politics
• Evangelism & Education
• Trends

API Planning & Design

API Planning & Design

Who Is Your Audience?

• Internal
• Partners
• Public
• End-Users of Apps

API Planning & Design

Pragmatic vs. Restful

• Design for Audience
• Hackable
• Simplicity
• Low Barrier to Entry

API Planning & Design

APIs Are a Contract

• Self-Service
• Reliable
• Stable
• Life Cycle
• Backwards Compatible
• Deprecation

API Planning & Design

APIs Are a Contract

API Building Blocks

API Building Blocks

Technology of APIs

• Pragmatic REST
• JSON / XML
• Webhooks
• oEmbed

API Building Blocks

Business of APIs - Onboarding

• Getting Started Guide
• Self-Service Registration
• API Best Practices
• Frequently Asked Questions (FAQ)

API Building Blocks

Business of APIs - Documentation

• List of Endpoints
• Documentation
• API Explorer

API Building Blocks

Business of APIs - Documentation - Explorer

API Building Blocks

Business of APIs - Documentation

• List of Endpoints
• Documentation
• API Explorer
• Interactive Documentation

API Building Blocks

Business of APIs - Documentation - Interactive Docs

API Building Blocks

Business of APIs - Documentation

• List of Endpoints
• Documentation
• API Explorer
• Interactive Documentation
• Error Response Codes

API Building Blocks

Business of APIs - Code

• Code Libraries
• Software Development Kits (SDK)
• Starter Projects
• Application Gallery

API Building Blocks

Platform Development Kits (PDK)

API Building Blocks

Business of APIs - Mobile

• iOS
• Android
• Windows
• HTML5

API Building Blocks

Mobile - Backend as a Service (BaaS)

API Building Blocks

Mobile - Backend as a Service + Frontend as a Service

API Building Blocks

Business of APIs - Embeddable

• Buttons
• Badges
• Widgets

API Building Blocks

Business of APIs - JavaScript APIs

• Syndication
• Proxy
• Security
• Hackable

API Building Blocks

Business of APIs - Self-Service Support

API Building Blocks

Business of APIs - Direct Support

• Email
• Phone
• Ticket System
• Paid Support
• Office Hours

API Building Blocks

Business of APIs - Communications

• Blog
• E-Newsletter
• Facebook
• Google+
• LinkedIn
• Twitter

API Building Blocks

Business of APIs - Updates

• Change Log
• Roadmap
• Status Dashboard

API Building Blocks

Business of APIs - Resources

• Case Studies
• How-To Guides
• Webinars
• White Papers

API Building Blocks

Business of APIs - Environment

• Sandbox
• Production

API Building Blocks

Business of APIs - Developer Account

• Account Settings
• Application Manager
• Billing History
• Developer Dashboard
• Reset Password
• Usage Logs & Analytics

API Building Blocks

Business of APIs - Discovery

• WADL
• Swagger
• IO Docs
• Google

API Building Blocks

Tools for Deploying APIs - Swagger

API Building Blocks

Discovery - APIhubs

API Building Blocks

Discovery - IDE

API Building Blocks

Github for Public Engagement

API Politics

API Politics

• Education
• Investment
• Budgets
• Licensing
• Data Ownership
• Data Retention
• Terms of Use
• Privacy
• Branding

API Politics

Politics of APIs

We Are Still Studying...

And Understanding the Politics of APIs!

What Works and What Doesn't!

API Evangelism & Education

API Evangelism & Education

Blogging

• Projects
• Hacking
• Storytelling
• Syndication

API Evangelism & Education

Developer Engagement

• New User
• Active User
• Historical
• Social Engagement

API Evangelism & Education

Forum Management

• Maintain
• Stories

API Evangelism & Education

GitHub Management

• Code
• Relationship
• Projects

API Evangelism & Education

QA Management

• Profile Maintenance
• Wiki & Knowledgebase
• Stack Exchange
• Quora
• QA Seeding

API Evangelism & Education

Social Management

• Twitter
• LinkedIn
• Facebook
• Google+

API Evangelism & Education

Social Bookmarking

• Hacker News
• StumbleUpon
• Reddit

API Evangelism & Education

Roadmap

• Communicate
• Change Log
• Roadmap
• Status Dashboard

API Evangelism & Education

Reporting

• Activity By User Group
• New Registrations / Per API
• Volume of Calls / Per API
• Other Innovative Metrics?

API Evangelism & Education

Internal Reporting

• Reporting
• Storytelling
• Showcase

API Evangelism & Education

Events

• Conferences
• Workshops
• Hackathons

API Evangelism & Education

Events - Internal Hackathons

• Goals & Objectives
• Prizes and Incentives
• Size and Scope
• Niche and Verticals
• SaaS and Process
• Data and Visualizations

API Evangelism & Education

Iterate

• Rapid Cycles
• Keep Active
• Innovate
• Try New Things
• Don't Be Afraid to Fail
• Measure
• Feedback Loop

API Evangelism & Education

You Probably Don't Have Resources To Do Everything

But, Is It Something Your Whole Team Can Help Own?

And, Consider Alpha Developers / Evangelist Within Community!

API Trends

• Aggregation
• Interoperability
• Transformation
• Automation
• Voice

Enterprise App Factory Stages

• Planning & Design - Know Your Goals
• Building Blocks - Proper Platform
• Politics - Balanced Approach w/ Protection
• Evangelism & Education - Knowledge and Awareness

Enterprise App Factory

Production & Deployment

• APIs Are More Than Tech
• APIs Require a Business Approach
• Politics Can Be Biggest Killer of APIs
• Focus on Delivering Value
• Establish Cross Platform Efficiency
• Healthy Developers
• Quality Applications