Open APIs Design

341
-1

Published on

Presentation from OpenSource Expo
- Why APIs ?
- Impl recommendations
- Analytics

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

  • Be the first to like this

No Downloads
Views
Total Views
341
On Slideshare
0
From Embeds
0
Number of Embeds
3
Actions
Shares
0
Downloads
16
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

Open APIs Design

  1. 1. Sub$tle  text Last Updated: June 2014 VP,  Product  Management   Isabelle  Mauny APIs   Design  and  Development Thursday, June 26, 14
  2. 2. 2 About  the  speaker... ๏ French  na)ve ๏ Living  in  Spain ๏ Works  mostly  with  Sri  Lanka ๏ 18  years  of  IBM,  4  years  in  startups ๏ Managing  the  overall  WSO2  porDolio ๏ Linux  command  line  user Thursday, June 26, 14
  3. 3. Many  APIs  ! 3 Thursday, June 26, 14
  4. 4. 4 Thursday, June 26, 14
  5. 5. Why  APIs  ? 5 Mobile  Apps  Development Marke)ng  channel Find  new  customers Drive  Innova)on Drive  Internal  Projects Integra)on  with  Partners Sales  Channel New  Product Thursday, June 26, 14
  6. 6. Ok,  I  am  convinced...   Now  what  ?   6 Thursday, June 26, 14
  7. 7. 7 ๏ Service  deals  with  implementa)on ๏ API  deals  with  subscrip)on  (consumer) ๏ Two  very  dis)nct  life  cycles  ! ๏ You  don’t  need  the  service  to  create  the  API... Services  and  APIs Thursday, June 26, 14
  8. 8. 8 Building  a  Managed  API ๏ Crea)ng  APIs  (interface,  docs,  samples,etc.) ๏ Adver)sing  APIs ๏ Making  APIs  subscribe-­‐able  by  consumers ๏ Associa)ng  SLAs ๏ Securing  APIs ๏ Mone)za)on  and  Analy)cs Thursday, June 26, 14
  9. 9. Magic  API  triangle 9 RESTful JSON OAuth Thursday, June 26, 14
  10. 10. SOAP  vs.  REST 10 Thursday, June 26, 14
  11. 11. 11 Thursday, June 26, 14
  12. 12. 12 Thursday, June 26, 14
  13. 13. JSON  vs.  XML 13 Thursday, June 26, 14
  14. 14. OAuth2 ๏ Standard  used  by  most  API  billionaires  (  TwiWer,  Facebook,  Google  for  example) ๏ Covers  authoriza)on  to  access  selected  informa)on/data  (scopes) ๏ Authen)ca)on  is  covered  using  OpenID  Connect  protocol ๏ Mul)ple  grant  types:  Authoriza)on  code  (below),  client_creden)als,  password,   SAML  ,  Kerberos) 14 Thursday, June 26, 14
  15. 15. 15 Need  for  API  Versioning ๏ Need  to  support  API  evolu)on ๏ While  Maintaining ๏ Backward  compa)bility  -­‐>  Func)onality ๏ Rates/ThroWling  agreements ๏ Different  versioning  mechanisms Thursday, June 26, 14
  16. 16. 16 API  Versioning  Strategies ๏ Version  as  a  query  parameter ๏ NeUlix  -­‐  hWp://api.neDlix.com/catalog/)tles/series/70023522?v=1.5 ๏ Google  Data  API  -­‐  “GData-­‐Version:  X.0″₺  or  “v=X.0″₺ ๏ Version  as  part  of  URI ๏ Salesforce  -­‐  hWps://na1.salesforce.com/services/data/v20.0/sobjects/Account/ ๏ TwiYer  -­‐  hWps://api.twiWer.com/1.1/statuses/men)ons_)meline.json ๏ Version  as  a  date  in  URI ๏ Twilio  -­‐  /2010-­‐04-­‐01/Accounts/{AccountSid}/Calls ๏ hWp://www.twilio.com/docs/api/rest/making-­‐calls ๏ Version  as  a   ๏ Custom  HTTP  Header ๏ Accept  Header Thursday, June 26, 14
  17. 17. 17 You  can’t  manage   what  you  can’t  measure. Thursday, June 26, 14
  18. 18. 18 Why  AnalyZcs  and  API  Management  are  important  together? ๏ Build  confidence  in  the  API  model ๏ Understand  your  customer   ๏ Help  manage  services  and  versions ๏ e.g.  understand  when  deprecated  services  can  be  re)red ๏ Plan  beWer ๏ Monitor  the  growth  of  aggregated  API  traffic ๏ Monitor  the  growth  of  specific  apps ๏ Make  sure  you  capture  all  events  right  from  beginning  of   project. Thursday, June 26, 14
  19. 19. Monitoring 19 Thursday, June 26, 14
  20. 20. Deployment 20 API Management Layer Services Layer Applications Cloud Services Mediation Layer Services Composition Services Orchestration Thursday, June 26, 14
  21. 21. Who  is  WSO2  ?   ๏ Open  Source  Middleware  PlaDorm   Provider ๏ All  products  are  released  under  Apache   2.0  License ๏ No  community  vs.  Enterprise  edi)ons ๏ Provides  Integra)on,  API  Management   and  Mobile  management  products ๏ 350+  people  in  Sri  Lanka,  USA  and   Europe 21 Thursday, June 26, 14
  22. 22. References ๏ OAuth   ๏ hWp://blog.facilelogin.com/ 2013/02/why-­‐oauth-­‐it-­‐self-­‐is-­‐not-­‐ authen)ca)on.html ๏ hWp://openid.net/specs/openid-­‐ connect-­‐basic-­‐1_0.html ๏ WSO2  API  Manager ๏ wso2.com/products/api-­‐manager/ 22 Thursday, June 26, 14
  23. 23. Contact  us  ! Thursday, June 26, 14
  1. A particular slide catching your eye?

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

×