©2013 Software AG. All rights reserved. ©2013 Software AG. All rights reserved.
Daniel Adelhardt Director, Product Management Robert Rowe Sr. Manager, Product Marketing
Unlock the Value of Your Unique Assets with a Robust API
©2013 Software AG. All rights reserved. For internal use only
2 |
APIs are a High Volume, Billion Dollar Business
Salesforce.com generates half of its $2.3B in revenue via APIs
$2B/yr. “90% of what we do is business through APIs”
Twitter processes 13B transactions per day via its APIs. Google processes about 5B
transactions per day via its APIs
Enabling Partners
300,000 registered apps
©2013 Software AG. All rights reserved. For internal use only
3 |
What is an API?
• It’s a service
©2013 Software AG. All rights reserved. For internal use only
4 |
New Methods to Reach Customers Via Apps
WEB APPS
1 billion 1 trillion
TRADITIONAL IT API PLATFORM
But why would any organization willingly risk exposing its most precious data assets over the Web?
©2013 Software AG. All rights reserved. For internal use only
5 |
The App and API Value Chain
IT Systems
Delighted Customer
Apps
App Developer
API PLATFORM
©2013 Software AG. All rights reserved. For internal use only
6 |
Business Reasons for Exposing APIs
Foster Innovation
Find New Sources of Revenue
Self-service Customers,Partners
APIs provide Business Value
Power Mobile Apps
©2013 Software AG. All rights reserved. For internal use only
7 |
How Many Apps Are There?
Source: http://www.pureoxygenmobile.com/how-many-apps-in-each-app-store/
iTunes, Google Play, Windows Phone Marketplace, Blackberry World
©2013 Software AG. All rights reserved. For internal use only
8 |
©2013 Software AG. All rights reserved. For internal use only
9 |
API Business Models – Show Me The Money!
Source: 20 API business models in 20 minutes, John Musser, ProgrammableWeb, API Strategy Conference, 2013
Bake your business model into your API
©2013 Software AG. All rights reserved. For internal use only
10 |
The Time for API Adoption is Now!
Key Points:
• The App economy is not limited to a single industry
• Remixing data from multiple sources is emerging as a hot new business model (i.e. mashing up maps with transit data)
• Numerous reasons to expose APIs • Many business models for making
money with APIs
©2013 Software AG. All rights reserved. For internal use only
11 | ©2013 Software AG. All rights reserved. For internal use only ©2013 Software AG. All rights reserved. For internal use only
How to Implement a Robust API Strategy
©2013 Software AG. All rights reserved. For internal use only
12 |
Framework to Build a Robust API Platform
API Goals & Prioritization
(Identification)
Definition & Realization
(Actualization)
Deployment & Optimization (Operations)
©2013 Software AG. All rights reserved. For internal use only
13 |
Decide on the Business Goals of your API
Targeted Audience
Business Model
Marketing Strategy
©2013 Software AG. All rights reserved. For internal use only
14 |
Is your API well provisioned?
Infrastructure
Processes
People
©2013 Software AG. All rights reserved. For internal use only
15 |
Provide Simple & flexible APIs • Provide choices –
• Data Formats • Protocols • Authentication
• Get familiar with API Design Patterns
©2013 Software AG. All rights reserved. For internal use only
16 |
Building an API is a lot like building a UX
Mock Up Try out
Refine
Implement Provision
Incorporate User Feedback
©2013 Software AG. All rights reserved. For internal use only
17 |
Your Protocol Choices – SOAP to REST?
• RESTful APIs are clearly perceived as state of the art
• BUT: SOAP also provides unique advantages
• Decide based on your API audience • Or design for both
Source: ProgrammableWeb, based on 5100 API’s as of Feb 2013
Don’t let Hype drive your design choices!
©2013 Software AG. All rights reserved. For internal use only
18 |
JSON or XML – your payload format choices?
• Verbosity • Extensible • Strongly typed • More complex • Namespaces • Wide range of layered technologies
• More compact • Not extensible by design • Simple syntax • Ambiguity • Faster
XML JSON
Don’t let Hype drive your design choices!
©2013 Software AG. All rights reserved. For internal use only
19 |
Optimize for Cloud & Mobile
Infrastructure Considerations • API Result Caching • Leverage Compression (GZIP) • Traffic Management • High Availability
©2013 Software AG. All rights reserved. For internal use only
20 |
Some API Design Best Practices
GET http://myhost/myAPI/info? fields=name, e-mail
GET http://myhost/myAPI/info? Offset=50&Limit=25
GET http://myhost/myAPI/info? Limit=25
GET http://myhost/myAPI/info? Sort=name&order=ASC
Partial Responses
Limit Results
Pagination
Service side Sorting
GET http://myhost/v1/myAPI/.. Design for Versions
©2013 Software AG. All rights reserved. For internal use only
21 |
API Façade implemented by an API Gateway
Authentication & Authorization
Security & Intrusion Protection
Traffic Optimization & Shaping
Monitoring & SLA Management
API Gateway
API Facade
Backends
©2013 Software AG. All rights reserved. For internal use only
22 |
Managing the lifecycle of your API
Salesforce: /services/data/v20.0/sobjects/Account
Intuit: /api/v1/app/BillingStatus/<appid>
“Communication leads to community that is, to understanding, intimacy and mutual valuing.”
- Rollo May
Dependencies & impact analysis API versioning Provisioning, deprecation & retirement
©2013 Software AG. All rights reserved. For internal use only
23 |
Analyse your API’s usage
Traffic
QoS
MarkeEng
Support
Trends Business
“You can't manage what you can't measure” - Peter Drucker
Leverage Analytics
©2013 Software AG. All rights reserved. For internal use only
24 |
Delighting your developers • Make it easy to find APIs • Document APIs properly • Provide Sample Code
or SDKs • Share Sample Apps • Evangelize • Sponsor Hackathons
Great Documentation
Communicate & Evangelize
©2013 Software AG. All rights reserved. For internal use only
25 | ©2013 Software AG. All rights reserved. For internal use only ©2013 Software AG. All rights reserved. For internal use only
The Software AG API Management Suite
©2013 Software AG. All rights reserved. For internal use only
26 |
Why do APIs need to be managed? AP
I PL
ATFO
RM
Partners
Affiliates
Internal Developers
ISV’s
Provision APIs? Retire APIs?
Secure internal assets?
Meter Usage?
API Provider App Developer
Onboard developers?
Provide tiered access?
Sign up for access?
Understand usage?
Track their KPIs?
©2013 Software AG. All rights reserved. For internal use only
27 |
Mediator
Typical Deployment Architecture
Enterprise Edge
API Consumers
API Mediation
Secure Enterprise Network
Optional Load Balancer
Backend Services
API Invocation
API Lifecycle
Edge Security
API Portal
API Metering and Analytics
Mediator
Enterprise Gateway
CentraSite
©2013 Software AG. All rights reserved. For internal use only
28 |
Benefits of Software AG’s API Management Suite
Full Lifecycle
Control over your APIS
Single, unified
solution for both internal
as well as external APIs
Scale your API
deployments rapidly with out-of-the-
box Terracotta
caching
Leverage proven
webMethods technology recognized by leading analysts
Achieve faster time-
to-value with Prime
methodology and our
expertise