My opening keynote for the 2016 Nordic APIs Platform Summit held in Stockholm, Sweden. In it I describe the 6 Insights that guide Nordic APIs content and events, including API Platforms, API Strategy, API Business Models, API Strategy, API Design, API Security, and API Marketing.
1. Introduction to the
Art of API Practice
2016 Platform Summit
Stockholm, Sweden
Bill Doerrfeld @DoerrfeldBill
Slides available: Slideshare.com/NordicAPIs
2. "REST is software design on the scale of decades:
every detail is intended to promote software
longevity and independent evolution. Many of the
constraints are directly opposed to short-term
efficiency. "
-Roy Fielding
Inspiration:
3. Why Build for Decades?
➢ APIs will prevail
➢ Coding "just enough" rarely stands the test of
time
➢ Helps focus on entire system needs
➢ Avoid inadaptability as technology evolves
➢ "Agile" shouldn't negate future planning
➢ But most importantly...
6. Insight #1 Platform
• Onboarding: why become
API-first?
• Validation: Successful model API
Platforms
• Momentum: Tracking disruption,
large industry movement
• Leadership: "Convincing the
Architect," intrapreneurship.
7. An API Platform is when...
➢ The API enables access to the organization’s core
value proposition
➢ Is technically and non-technically scalable
➢ Enables consumers to create shared value
➢ Is instrumental in securing the organization’s
position as a market leader
➢ Is seen by top management as business critical
8. Onboarding: Why be API-fied?
• It’s strategic for most companies to have an API
• APIs enable business to become more niche
• APIs affect all industries
• APIs empower entrepreneurs
• An economy has formed
9. Validation: Great API stories
● Consolidation of content
streaming pipeline
● Disrupted entertainment
industry
● Heightened brand
awareness
● Profit generation
● Facilitated move to server
provider
● Advertising benefits
● Competitive edge
● Embeddable service
10. Momentum: Industry at Large
● 16,000+ APIs
● Composable
● Impacted sectors:
○ IT, DevOps, IoT,
consumer
experiences, mobile,
data analytics, AI, &
many more...
11. Leadership: The API Intrapreneur
• "Convincing the Architect" : (Perhaps we're beyond this)
• Disseminating best practices
• Fostering internal culture
• Security
• Agility
• Style Guide
12. Insight #2 Strategy
• Valuation: Determine the
value of digital assets
• Niche: Carve out unique
value
• Provisioning: Decide who
sees what
• Forecast: Respond to tech
evolution
13. Valuation: Asset Valuation
• Types of APIs
• Data: GET User data, profile data,
• Ex. Financial data
• Functionality: Processing.
• Ex. Payment API
• Infrastructure: What internal processes could
others benefit from?
• Ex. Github's Hubot
16. ➢ How will industries
that rely on APIs
evolve?
○ IoT
○ B2B
○ FinTech
○ Healthcare
○ Marketing
○ Utilities
○ Green tech
○ AI
Forecast: Engage with Evolution
17. Insight #3 Business Models
• Monetization: Monetize as own
product
• Premium: Package as upsell
• Indirect ROI: content
distribution, R&D, ...
• Economy: Companies whose
business is APIs
● John Musser 20+ Business Models
● Rob Zazueta 5 Monetization Models
Resources:
18. Monetization: How to monetize?
• Free
• Freemium
• Help developers grow
• Ex. Affectiva offers free SDK & API for small
businesses
• Direct Charge
• Per call
• subscription
● How to Grow and Profit Using a
Freemium API Monetization Model
Resources:
21. Economy: Analyze the Market
• FinTech, Open banking
movement
• AI
• IPOs; Twilio
• Sectors for exploitation with
APIs
• Novel companies
● Ten New Breeds of API Businesses...
● CMA Will Save Open Banking APIs...
Resources:
22. Insight #4 Design
• Style: API behavior, best
practices
• Development: Tools for
construction
• Reference: Ways to present
an API to machines & humans
• Testing: Testing throughout
API lifecycle
23. Style: Industry best practices
• Type: REST / SOAP. GraphQL
• Data formats: JSON, YAML,
• Style considerations:
● API Handyman’s API Stylebook
Resources:
# of Endpoints Asynchronicity Filtering Pagination
Data Format Error Handling HTTP Methods Caching
Hypermedia and More...
24. Development: Editors
• API Design Editors, many open source
• Design —> documentation publishing,
hosting, management, or more. Examples:
● Industry Guide on API Design, Kin
Lane
Resources:
25. Reference: Documentation
• API Definitions:
• Machine vs Human readable
● What is the Difference Between API
Documentation, Specification, and Definition?
Resources:
27. "the effort required to design something is
inversely proportional to the simplicity of the
result. "
-Roy Fielding
Inspiration:
28. Insight #5 Security
• Identity: Tracking consumer identity
• Access: Protecting resources
• Vulnerabilities: Common hacking methods
and ways to prevent
• Debugging: To prevent exploits or major
system failures
29. Insight #6 Marketing
• Discovery: How is your API
found?
• Dev Portal: docs, SDK, code
samples,
• Advocacy: Support for
customers; DevRel
• Promotion: How to actively
evangelize an API?
30. Discovery: How find API?
• SEO: Google
• Optimize API banding, copy, keyword frequency
• separate homepages for each API
• List in Directories:
• Services Discovery Automation
● Tips to Improve Discoverability of
your API
Resources:
31. Dev Portal: 7 Ingredients for a
Superb Dev Center
● 7 Ingredients That Make Up a Superb
Developer Center
Resources:
Getting Started Guide Authentication Guide
API Documentation Testing Console
Dev Resources
(code sample, SDK, libraries)
Support Channels
Platform Policy
32. Advocacy: Developer Relations
• Dev outreach
increases:
• Awareness
• Understanding
• Vision
• Ways to form a
community:
• Email, chat, forum,
conferences, Knowledge base,
blog, content, demos, use cases
● DevRel: How to Offer Unparalleled
Developer Outreach
Resources:
33. Promotion: How evangelize an
API?
• Press Releases
• API Blogs & Digests
• Social channels
• Hackernews, Product Hunt, Beta
List, Stackshare.io, Reddit.
● Utilizing Product Hunt to Launch Your
API
Resources:
34. "The Web is now philosophical engineering.
Physics and the Web are both about the
relationship between the small and the large."
-Tim Berners-Lee
Inspiration:
36. “Building on the scale of decades must inherently
consider all aspects of API practice, including
things like dev relations and business acumen, as
this will inform technical development.”
-Me :)
Final Thought:
37. • Architect and Design APIs
on the Scale of Decades
• Assemble knowledge
from conference
• Contributed posts from
speakers & blog team
• Release: Q1 2017
• Follow progress: Leanpub
The Art of API Practice [eBook]
38. Nordic APIs Knowledge Center
Marketing Strategy Business Security Platforms
• 10 eBooks for free download. Examples:
40. Keep in touch!
• Follow us on Twitter: @NordicAPIs
• Sign up for our Newsletter: nordicapis.com/newsletter
• Follow our blog: nordicapis.com/blog
• Contributions are welcome!