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

  • Design and Code
  • Documentation
  • Software development kits (SDK)
  • Code Samples (Gists)
  • Developer Authentication
  • Developer Profiling
  • Presentations and Guides
  • Issue Management
  • Roadmaps
  • Hackathons
  • Developer Authentication
  • TOS, Privacy, and Branding

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