0%

A lot of work is required to release an API, but the effort doesn't always pay off. Overplanning before an API matures is a wasted investment, while underplanning can lead to disaster. The second edition of this book provides maturity models for individual APIs and multi-API landscapes to help you invest the right human and company resources for the right maturity level at the right time.

How do you balance the desire for agility and speed with the need for robust and scalable operations? Four experts show software architects, program directors, and product owners how to maximize the value of their APIs by managing them as products through a continuous lifecycle.

  • Learn which API decisions you need to govern
  • Design, deploy, and manage APIs using an API-as-a-product (AaaP) approach
  • Examine 10 pillars that form the foundation of API product work
  • Learn how the continuous improvement model governs changes throughout an APIâ??s lifetime
  • Explore the five stages of a complete API product lifecycle
  • Delve into team roles needed to design, build, and maintain your APIs
  • Learn how to manage APIs published by your organization

Table of Contents

  1. Foreword from NGINX
  2. Foreword to the First Edition
  3. Preface
    1. Who Should Read This Book
    2. What’s in This Book
    3. The Outline
    4. What’s Not in This Book
    5. Conventions Used in This Book
    6. O’Reilly Online Learning
    7. How to Contact Us
    8. Acknowledgments
  4. 1. The Challenge and Promise of API Management
    1. What Is API Management?
    2. The Business of APIs
    3. What Is an API?
    4. More Than Just the API
    5. API Maturity Stages
    6. More Than a Single API
    7. Why Is API Management Difficult?
    8. Scope
    9. Scale
    10. Standards
    11. Managing the API Landscape
    12. Technology
    13. Teams
    14. Governance
    15. Summary
  5. 2. API Governance
    1. Understanding API Governance
    2. Decisions
    3. Decision Management
    4. Governing Complex Systems
    5. Governing Decisions
    6. Centralization and Decentralization
    7. The Elements of a Decision
    8. Decision Mapping
    9. Decision Design in Practice
    10. Designing Your Governance System
    11. Governance Pattern #1: Design Authority
    12. Governance Pattern #2: Embedded Centralized Experts
    13. Governance Pattern #3: Influenced Self-Governance
    14. Implementing Governance Patterns
    15. Evolving Your Solution
    16. Observability and Visibility
    17. Operating Models
    18. Develop a Strategy for Standards Management
    19. Summary
  6. 3. The API as a Product
    1. The Programmable Economy Is API-Led
    2. Price, Promotion, Product, Place → Everywhere
    3. Design Thinking
    4. Match People’s Needs
    5. Viable Business Strategy
    6. The Bezos Mandate
    7. Applying Design Thinking to APIs
    8. Customer Onboarding
    9. Time to Wow!
    10. Onboarding for Your APIs
    11. Developer Experience
    12. Knowing Your Audience
    13. Making It Safe and Easy
    14. Why Are Developers So Important in the API Economy?
    15. Developer Relations for APIs as a Product
    16. API-as-a-Product Monetization and Pricing
    17. Summary
  7. 4. The Pillars of an API Product
    1. Introducing the Pillars
    2. Strategy
    3. Design
    4. Documentation
    5. Development
    6. Testing
    7. Deployment
    8. Security
    9. Monitoring
    10. Discovery
    11. Change Management
    12. Using the Pillars Together
    13. Applying Pillars When Performing Planning
    14. Using the Pillars for Creation
    15. Using the Pillars to Operate and Run
    16. Summary
  8. 5. Continuous API Improvement
    1. Managing Change Continuously
    2. Incremental Improvement
    3. API Change Velocity
    4. Changing an API
    5. The API Release Lifecycle
    6. Changing the Interface Model
    7. Changing the Implementation
    8. Changing the Instance
    9. Changing the Supporting Assets
    10. Improving API Changeability
    11. Effort Costs
    12. Opportunity Costs
    13. Coupling Costs
    14. Isn’t All This Just BDUF?
    15. Summary
  9. 6. API Styles
    1. APIs Are Languages
    2. The Five API Styles
    3. Tunnel Style
    4. Resource Style
    5. Hypermedia Style
    6. Query Style
    7. Event-Based Style
    8. How to Decide on API Style and Technology
    9. Avoid Painting Yourself into a Style Corner
    10. Summary
  10. 7. The API Product Lifecycle
    1. Measurements and Milestones
    2. OKRs and KPIs
    3. Defining an API Objective
    4. Identifying Measurable Results
    5. The API Product Lifecycle
    6. Stage 1: Create
    7. Stage 2: Publish
    8. Stage 3: Realize
    9. Methodology: Value Proposition Interface Canvas
    10. Stage 4: Maintain
    11. Stage 5: Retire
    12. Applying the Product Lifecycle to the Pillars
    13. Create
    14. Publish
    15. Realize
    16. Maintain
    17. Retire
    18. Summary
  11. 8. API Teams
    1. API Roles
    2. Business Roles
    3. Technical Roles
    4. API Teams
    5. Teams and API Maturity
    6. Scaling Up Your Teams
    7. Teams and Roles at Spotify
    8. Factors for Your Scaling Approach
    9. Culture and Teams
    10. Recognizing Conway’s Law
    11. Leveraging Dunbar’s Numbers
    12. Enabling Alexander’s Cultural Mosaic
    13. Supporting Experimentation
    14. Summary
  12. 9. API Landscapes
    1. API Archaeology
    2. API Management at Scale
    3. The Platform Principle
    4. Principles, Protocols, and Patterns
    5. API Landscapes as Language Landscapes
    6. API the APIs
    7. Understanding the Landscape
    8. The Eight Vs of API Landscapes
    9. Variety
    10. Vocabulary
    11. Volume
    12. Velocity
    13. Vulnerability
    14. Visibility
    15. Versioning
    16. Volatility
    17. Summary
  13. 10. API Landscape Journey
    1. Structuring Guidance in the API Landscape
    2. The Lifecycle of Guidance
    3. The Center for Enablement
    4. C4E Team and Context
    5. Maturity and the Eight Vs
    6. Variety
    7. Vocabulary
    8. Volume
    9. Velocity
    10. Vulnerability
    11. Visibility
    12. Versioning
    13. Volatility
    14. Summary
  14. 11. Managing the API Lifecycle in an Evolving Landscape
    1. Managing an Evolving Landscape in Practice
    2. Socialize Your “Red Lines”
    3. Platforms Over Projects (Eventually)
    4. Design for Consumers, Producers, and Sponsors
    5. Test, Measure, and Learn
    6. API Products and Lifecycle Pillars
    7. API Landscapes
    8. Decision Points and Maturity
    9. Landscape Aspects and API Lifecycle Pillars
    10. Strategy
    11. Design
    12. Documentation
    13. Development
    14. Testing
    15. Deployment
    16. Security
    17. Monitoring
    18. Discovery
    19. Change Management
    20. Summary
  15. 12. Continuing the Journey
    1. Continuing to Prepare for the Future
    2. Continue Managing Every Day
  16. Index
3.141.24.134