Upgrade to Pro — share decks privately, control downloads, hide ads and more …

Managing APIs across the lifecycle

Managing APIs across the lifecycle

By Vanessa Ramos and Christina Lin
Red Hat Summit, Boston 2017

Avatar for Vanessa Ramos

Vanessa Ramos

May 04, 2017

More Decks by Vanessa Ramos

Other Decks in Technology

Transcript

  1. 2 WHY ARE WE HERE • API lifecycle 101 •

    Phases of the API lifecycle ◦ Plan & Design ◦ Built, Integrate & Deploy ◦ Operate & Manage ◦ Share & Engage ◦ End of life • Demo
  2. 7 API LIFECYCLE The API lifecycle Plan Design Build Integrate

    Deploy Operate Manage Share Engage End of Life 1 2 3 4 5
  3. 9 API DESIGN The API lifecycle 1 Integration Granularity Availability

    IT Assets Data Integrity Security Policies Controls
  4. 10 SPEAK THE SAME LANGUAGE The API lifecycle 1 •

    Vendor neutral • Industry standard • Choice of tools • Spec as the source of truth • Mock Testing
  5. 11 • Web based, visual API Designer • Code optional

    • Fully Open Source • Design collaboratively http://apicur.io The API lifecycle 1 APICURIO STUDIO
  6. 13 Integration != Management - Composing Services - Authentication -

    Transformation - Authorization The API lifecycle 2 BEST PRACTICE 101
  7. 20 API Provider API Consumer The API lifecycle 3 API

    Manager Access Control Usage Policies Traffic Analytics API Monetization Dev portal Interactive API Docs APIcast API Gateway API MANAGEMENT
  8. ACCESS CONTROL 21 • Authenticate traffic • Restrict by policy

    • Drop unwelcome calls • Protect backend services • Generate overage alerts • Impose rate limits The API lifecycle 3
  9. USAGE POLICIES 22 API Services Rate Limits Pricing Application #1

    Application #2 Application #3 Internal teams Strategic partners • Endpoint A • Endpoint B • X calls/ minute • Y calls/ day • Free • $X per month • $Y per call Developers The API lifecycle 3
  10. 24 TRAFFIC ANALYTICS • Data capture • Analysis of traffic

    patterns • Learn how your APIs are being used… • … and fine-tune your API program accordingly The API lifecycle 3
  11. 26 SEAMLESS DEVELOPER EXPERIENCE • Make it very clear what

    the API does • Providing instant sign up • Providing free access • Being transparent about pricing • Having great documentation From John Musser’s OSCON 2012 talk. The API lifecycle 4
  12. 27 DEVELOPER PROGRAM The API lifecycle 4 Developer portal Pilots

    / Case studies Community building Measure Acceleration
  13. 30 API RETIREMENT & CHANGE MANAGEMENT • Breaking changes vs.

    non-breaking changes • Communication and migration plan • Contract, API terms • The end of the line The API lifecycle 5
  14. 33 MAIN TAKEAWAYS APIs are products Plan & Design Design

    with your user in mind API spec as the unique source of truth. Build, Integrate & Deploy Integration =! Mgmnt Pipelines to support CI/CD automation Operate & Manage Secure your API Diff. types of access for diff. types of users Share & Engage Provide a seamless dev. experience End of Life Communicate changes in your API(s) 1 2 3 4 5
  15. Q&A