BUILD, HOST AND MANAGE
YOUR CUSTOM API IN LESS THAN AN HOUR

All-in-one platform for Web APIs
http://apispark.com

Jérôme ...
WEB API PROJECT
TYPICAL LIFE CYCLE

1) Do It Yourself (DIY)
long, risky, expensive but highly flexible

Create

Host

Mana...
Step 1

BUILD YOUR DATA SOURCE
DEFINE YOUR DOMAIN MODEL
 Nothing new under the API sun !
 How is your domain model structured?
 Which information do y...
DIY APPROACH
 Select a database technology
 that scales

 Specify the schema
 tables / sets, keys / queries, indexes

...
PAAS WAY
DATABASE AS A SERVICE
Step 2

CREATE YOUR WEB API
SPECIFY YOUR WEB API
 What do you want to expose ?
 Which resources ?
 How to structure them ?

 Common practices
 RE...
DIY APPROACH
 Select an API framework that
 Lets you be productive and gets you on the way
 Leverages your skills
 Ens...
PAAS WAY
FULLY AUTOMATED
Step 3

DEPLOY YOUR WEB API
SPECIFY HOSTING NEEDS
 Who will access your API ?
 Public or Private ?
 Users, administrators, guests, support teams …
...
DIY APPROACH
 Choose a deployment target
 Private hosting with firewall / DMZ
 Public hosting : Cloud / Dedicated

 Se...
PAAS WAY
INSTANT DEPLOY AND AUTO SCALE
Step 4

PROMOTE YOUR API
GIVING ACCESS TO YOUR API
 Think about API documentation
 Which client SDKs to provide ?
 How to measure your API succe...
DIY APPROACH
 Write your API documentation
 Annotated your API code and generate ?
 Use HTML tooling ?
 Maintenance co...
PAAS WAY
GENERATE CLIENT SDKS
PAAS WAY
BUILT-IN ANALYTICS
DIY VERSUS PAAS
SUMMARY

From weeks to months

Web API manager
Current practice:
• Team of engineers
• Heterogeneous stack...
HOW MANY APIS ?
TO BUILD AND MAINTAIN

Browser

HTTP

Connected
devices

Pages + API

Smart
environment

Web Site

Busines...
FINAL THOUGHTS
 How to build 1 million API in 2017 ?
– with radically simpler PaaS for Web APIs
– truly democratize Web A...
KEEP IN TOUCH!

http://apispark.com
Twitter: @apispark
jlouvel@restlet.com

Learn about the ROA/D
methodology !
Upcoming SlideShare
Loading in...5
×

Build, host and manage your custom API in less than an hour

192

Published on

Presentation at APIWorld 2013 in San Francisco on 10/03/2013. Compares the Do It Yourself (DIY) and Platform as a Service (PaaS) approaches. Jérôme Louvel.

Published in: Technology
0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total Views
192
On Slideshare
0
From Embeds
0
Number of Embeds
2
Actions
Shares
0
Downloads
1
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

Build, host and manage your custom API in less than an hour

  1. 1. BUILD, HOST AND MANAGE YOUR CUSTOM API IN LESS THAN AN HOUR All-in-one platform for Web APIs http://apispark.com Jérôme LOUVEL jlouvel@restlet.com CEO October 3, 2013
  2. 2. WEB API PROJECT TYPICAL LIFE CYCLE 1) Do It Yourself (DIY) long, risky, expensive but highly flexible Create Host Manage Use 2) Platform as a Service (PaaS) integrated, fast, cost effective Promote
  3. 3. Step 1 BUILD YOUR DATA SOURCE
  4. 4. DEFINE YOUR DOMAIN MODEL  Nothing new under the API sun !  How is your domain model structured?  Which information do you want expose?  Common practices  Domain entities and properties  Reuse your data modeling experience  Use OOA/D methodology or similar → Then implement it
  5. 5. DIY APPROACH  Select a database technology  that scales  Specify the schema  tables / sets, keys / queries, indexes  Setup the database  On premise or in the Cloud  Ensure security, high availability and performances  From days to weeks
  6. 6. PAAS WAY DATABASE AS A SERVICE
  7. 7. Step 2 CREATE YOUR WEB API
  8. 8. SPECIFY YOUR WEB API  What do you want to expose ?  Which resources ?  How to structure them ?  Common practices  REST / Resource Oriented approach  Resources, representations, variants  Use ROA/D methodology and similar → Then implement it
  9. 9. DIY APPROACH  Select an API framework that  Lets you be productive and gets you on the way  Leverages your skills  Ensures your web API will scale and be secure  Write the code  Code, debug, unit tests  Read, write, update your data  Package the code  From days to weeks
  10. 10. PAAS WAY FULLY AUTOMATED
  11. 11. Step 3 DEPLOY YOUR WEB API
  12. 12. SPECIFY HOSTING NEEDS  Who will access your API ?  Public or Private ?  Users, administrators, guests, support teams …  Which SLA ?  How much traffic do you expect ?  How will you manage your API?  Don’t forget about global security stakes → Then implement it
  13. 13. DIY APPROACH  Choose a deployment target  Private hosting with firewall / DMZ  Public hosting : Cloud / Dedicated  Select an API management solution  Build your own from Open source, third party products  Leverage an API management service : plug it in tasks and side effects  Guaranty your SLA  Test, QA, iterate, benchmark…  From days to weeks to get started
  14. 14. PAAS WAY INSTANT DEPLOY AND AUTO SCALE
  15. 15. Step 4 PROMOTE YOUR API
  16. 16. GIVING ACCESS TO YOUR API  Think about API documentation  Which client SDKs to provide ?  How to measure your API success ?  Monitor access to your API  Usage statistics, analytics, trends  Promote your API online  Attract new API users
  17. 17. DIY APPROACH  Write your API documentation  Annotated your API code and generate ?  Use HTML tooling ?  Maintenance costs (versions sync)  Provide client SDKs  Write first SDKs  Pray for community contributions for others ?  Test, QA, iterate, etc.  From days to weeks to get started
  18. 18. PAAS WAY GENERATE CLIENT SDKS
  19. 19. PAAS WAY BUILT-IN ANALYTICS
  20. 20. DIY VERSUS PAAS SUMMARY From weeks to months Web API manager Current practice: • Team of engineers • Heterogeneous stack • Complex & expensive to develop and to operate From minutes to hours Web API definition Custom code Web API framework Hosting Generic PaaS API Spark • creation • hosting • management • usage All-in-one PaaS
  21. 21. HOW MANY APIS ? TO BUILD AND MAINTAIN Browser HTTP Connected devices Pages + API Smart environment Web Site Business Partners Internal IT
  22. 22. FINAL THOUGHTS  How to build 1 million API in 2017 ? – with radically simpler PaaS for Web APIs – truly democratize Web APIs ! Source: Wired / June 2013
  23. 23. KEEP IN TOUCH! http://apispark.com Twitter: @apispark jlouvel@restlet.com Learn about the ROA/D methodology !
  1. A particular slide catching your eye?

    Clipping is a handy way to collect important slides you want to go back to later.

×