apis for your business + stages of the api lifecycle
TRANSCRIPT
![Page 1: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/1.jpg)
APIs for your Business+
Stages of the API Lifecycle
API Workshop at TheFamily Paris, December 5, 2014
Nicolas Grenié !Hacker in Residence at 3scale.net Out-of-the-box API Management @3scale
![Page 2: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/2.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
Outline1. Four business benefits of APIs
2. The API lifecycle • Plan/Design • Build/Integrate • Operate/Manage • Share/Engage
3. Wrap-up and take-aways
![Page 3: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/3.jpg)
API !
Application Programming Interface
![Page 4: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/4.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
What’s an API?
" #
![Page 5: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/5.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
APIs for Developers
✴Enrich functionality
✴Increase attractiveness by new combinations
✴Leverage brand strength
✴Integrate more easily and quickly
![Page 6: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/6.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
APIs for Companies/Organisations
✴Create/revive revenue sources
✴Deliver wider reach
✴Foster (external) innovation
✴Increase efficiency
![Page 7: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/7.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
Example 1: Create/revive revenue sources
✴25% of revenue growth driven by APIs ✴750,000 fundraising pages created using
JustGiving APIs raising £76m ✴40% annual user growth
Source: http://www.3scale.net/resources/customer-stories/
![Page 8: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/8.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
Example 2: Deliver wider reach
✴700 partners created 50,000 third party apps/services
✴300m monthly uniques who see the brand on other sites
✴The API gave reach and brand awareness which would not have been
possible with traditional marketing.
(Dick Brouwer, TripAdvisor Director of Engineering)Source: http://bit.ly/1uk6Oo7
![Page 9: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/9.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
Example 3: Foster (external) innovation
✴Only 1 app developed by Fitbit in-house
✴Third party apps in Fitbit’s ecosystem accumulated
are worth $1m of development cost
Source: http://www.slideshare.net/faberNovel/why-shouldicareaboutap-is4/53
![Page 10: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/10.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
Example 4: Increase efficiency
✴Wrap every internal service with an API – or you are fired
✴Better re-usability, quicker integration, spot opportunities, get to market quicker (AWS)
Source: http://apievangelist.com/2012/01/12/the-secret-to-amazons-success-internal-apis/
![Page 11: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/11.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
But what really is the power of APIs ?
![Page 12: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/12.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
!
• APIs enable the creation of platforms.
• Platforms enable 2-sided / n-sided business models.
(aka Asymmetric Business Models)
See also VisionMobile report on Asymmetric Business Models:!http://www.visionmobile.com/product/asymmetric-business-models/
![Page 13: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/13.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
Asymmetric Business ModelsSide 1 Side 2..n
Get most of the services Pays
![Page 14: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/14.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
APIs enable the creation of platforms.
…can serve n victimized markets !
$ A platform
![Page 15: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/15.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
The API lifecycle and tools
![Page 16: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/16.jpg)
Plan /
Design
Build /
Integ
rate
Operate /
Manage
Share
/
Enga
ge
!
The API Lifecycle.
![Page 17: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/17.jpg)
Plan /
Design
Build /
Integ
rate
Operate /
Manage
Share
/
Enga
ge
!
The API Lifecycle.
![Page 18: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/18.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
Plan / Design
Why API? !
Alignment with overall business strategy What do we want to achieve?
![Page 19: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/19.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
Plan / Design•Resource modeling: Fine- vs coarse grained •Nouns and verbs (resources/HTTP)
•http://www.thoughtworks.com/insights/blog/rest-api-design-resource-modeling
•Decouple DB%API •“How to design APIs that last”
•http://apiux.com/2014/09/05/api-design-sustainability/ •API-first design
•https://pop.co/blog/why-we-chose-api-first-development/
![Page 20: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/20.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
Plan / Design
•Tools ✴API Blueprint ✴RAML ✴Swagger
!
•See also “Where APIs and Tooling Unite” •http://www.futureinsights.com/home/where-apis-and-tooling-unite.html
![Page 21: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/21.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
API Blueprint
![Page 22: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/22.jpg)
Plan /
Design
Build /
Integ
rate
Operate /
Manage
Share
/
Enga
ge
!
The API Lifecycle.
![Page 23: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/23.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
Coding toools• Ruby
• Grape http://www.confreaks.com/videos/475-rubyconf2010-the-grapes-of-rapid • Sinatra http://www.sinatrarb.com/
• PHP • Slim http://coenraets.org/blog/2011/12/restful-services-with-jquery-php-and-the-slim-framework/
• Node.js: • Express.js, Fortune.js • Restify http://mcavage.me/node-restify/
• ASP.net • Python:
• Flask Web framework for Python: http://flask.pocoo.org/ • Django for Python: http://www.django-rest-framework.org/
• Java: • JAX-RS • REST.li http://rest.li/index.html
hype: !App Now
![Page 24: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/24.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
var express = require('express'); //Create new instance of Express object!var app = express();! ! !!!app.get('/api', function(request, response) { //Do something to read a resource }); !app.post('/api', function(request, response) { //Do something to create a resource }); !app.put('/api', function(request, response) { //Do something to update a resource }); !app.delete('/api', function(request, response) { //Do something to delete a resource }); !!//Start the server!app.listen(3000);!!
![Page 25: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/25.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
!app.get('/api/account', function(request, response) { ! //Set content-type ! response.type('application/json'); ! //Send text response ! response.status(200).send( ! ! { message: 'Your balance is: '+ balance }); ! ! //...! }); !!app.put('/api/account', function(request, response) { //Get the change in balance!! balance = parseInt(request.body.updatebalance); ! //Update the balance... ! ! ! //Notify client ! response.status(200).send( ! ! { message: 'Your new balance is: ' + balance }); ! //... });!!//...
![Page 26: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/26.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
A demo: ‘Health’API!
!
!
• https://github.com/3scale/workshop-apistrat2014
!
• Deployed on Heroku:
• https://nicolashealthapi.herokuapp.com (UNSECURED!!)
![Page 27: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/27.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
A demo: ‘Health’API
• Test with Postman
• http://www.getpostman.com
• (test live APIs quickly)
![Page 28: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/28.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
Unsecured API – What’s the problem?
No knowledge about:
• Who accesses the API?
• What are they doing with the API?
• How to block someone?
• What traffic occurs when by whom?
![Page 29: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/29.jpg)
Plan /
Design
Build /
Integ
rate
Operate /
Manage
Share
/
Enga
ge
!
The API Lifecycle.
![Page 30: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/30.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
Operate / Manage
App / Website BackendAP
I
![Page 31: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/31.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
Operate / Manage
App / Website
API Management BackendAP
I
http://api.2445581123523.proxy.3scale.net:80
http://manfredhealthapp.herokuapp.com
![Page 32: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/32.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
Demo 1: Securing the API via API Management
![Page 33: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/33.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
Demo 2: API Analyticsvia API Management
![Page 34: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/34.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
What’s left to do ?
Your own deployment of the traffic agent.
![Page 35: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/35.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
Deployment
App / Website
API Management BackendAP
I
Plugin
ProxyOR#infrastructure
![Page 36: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/36.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
Minimum API OperationsAccess Control: authentication and authorization to
identify the originator of incoming traffic and ensure only permitted access.
Rate Limits and Usage Policies: usage quotas and restrictions on incoming traffic to keep loads predictable.
Analytics: data capture and analysis of traffic patterns to learn how the API is being used.
![Page 37: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/37.jpg)
Plan /
Design
Build /
Integ
rate
Operate /
Manage
Share
/
Enga
ge
!
The API Lifecycle.
![Page 38: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/38.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
Share / Engage
Image source: http://dx.jeremiahlee.com/
![Page 39: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/39.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
Developer Portal
Acceleration
Pilots / Case Studies
Community Building
Measure
Com
ms
So
cial
Med
ia
Even
ts
Evan
gelis
t
![Page 40: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/40.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
Demo 3: API Documentationvia API Management
![Page 41: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/41.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
API Management
For Developers
www.apitools.com
Out-of-the-box API Management
For API Providers
3scale.net
apistrategyconference.com
apicodex.3scale.net
Market Education & Evolution
APIs.io
![Page 42: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/42.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
Take-awaysThere can be an enormous benefit in APIs -- shown by many successful
examples.
It needs to be crystal clear what you want to achieve. The API needs to be
aligned with the business strategy.
APIs enable Asymmetric Business Models to tackle many markets.
Carefully consider all four stages in the API lifecycle.
Exposing data or services via APIs alone is not enough. Make sure you
secure, monitor and manage APIs.
![Page 43: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/43.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
APIs for your Business+
Stages of the API Lifecycle
• Q&A !
• Manfred Bortenschlager
!
• I work at 3scale.net
• Out-of-the-box API Management
• @3scale
![Page 44: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/44.jpg)
APIs for your Business+
Stages of the API Lifecycle
API Workshop at TheFamily Paris, December 5, 2014
Nicolas Grenié !Hacker in Residence at 3scale.net Out-of-the-box API Management @3scale
![Page 45: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/45.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
• www.apitools.com
![Page 46: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/46.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
APItools.com
• 1. Managing & Monitoring APIs
• 2. Modifying API calls
![Page 47: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/47.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
How does it work ?
My app APItools★ Manage APIs ★ Test & Debug ★ Modify API traffic ★ Analytics
requests
responses
Web APIs
Others…
![Page 48: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/48.jpg)
![Page 49: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/49.jpg)
![Page 50: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/50.jpg)
![Page 51: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/51.jpg)
![Page 52: APIs for your Business + Stages of the API Lifecycle](https://reader030.vdocuments.us/reader030/viewer/2022032419/55a3b77c1a28ab75548b464f/html5/thumbnails/52.jpg)
The Family - Paris - Nov. 2014 Nicolas Grenié - !picsoung
Tools for Developers
• APItools
• https://www.apitools.com/
!
• Postman
• http://www.getpostman.com/