Gartner Research

How to Successfully Implement API Management

Published: 17 May 2019

ID: G00370408

Analyst(s): Matt Brasier, Kevin Matheny

Summary

APIs are fundamental to digital business; however, exposing API endpoints without protection, monitoring or analytics creates risk and limits value. Application technical professionals responsible for publishing APIs must implement an API management solution to provide these essential capabilities.

Table Of Contents

Problem Statement

The Gartner Approach

The Guidance Framework

  • Prework
    • Understand Your Organization’s Goals for APIs and API Management
    • Select API Management Technologies and Conduct POCs
    • Locate or Define API Design Guidelines
  • Step 1: Identify the Success Criteria for Your Implementation
    • Determine the Scope of Your Responsibilities
    • Determine the Developer Communities You Are Serving
    • Determine the User Roles You Must Support
    • Will You Need to Monetize Your APIs?
  • Step 2: Define Strategies and Implement Processes
    • Determine How You Will Package APIs
    • Determine Your Security, Identity and Access Management Strategy
    • Implement Support and Escalation Procedures
  • Step 3: Define Your Target Architecture
    • Define the Types of API Gateway You Will Need
    • Determine How You Will Handle API Mediation
    • Map Your Deployment Architecture
  • Step 4: Provision and Configure the Platform
    • 1. Provision the Core Components of the Platform
    • 2. Implement IAM and Security
    • 3. Import or Create Users
    • 4. Configure API Packages
    • 5. Import APIs and Documentation
    • 6a. Configure Endpoint Protection Capabilities
    • 6b. Implement API Mediation
    • 6c. Implement Monetization
    • 6d. Configure Analytics and Reporting
    • 7. Launch the Platform
  • Follow-up: Operate and Evolve the Platform

Risks and Pitfalls

  • Risk: Pressure to Begin Implementation Immediately
  • Risk: Analysis Paralysis
  • Risk: API Developers Reject the Platform
  • Risk: Changing Expectations
  • Pitfall: Treating API Support as an Operations Problem
  • Pitfall: Out-of-Date Documentation Creates Consumer Frustration
  • Related Guidance

Gartner Recommended Reading

©2020 Gartner, Inc. and/or its affiliates. All rights reserved. Gartner is a registered trademark of Gartner, Inc. and its affiliates. This publication may not be reproduced or distributed in any form without Gartner’s prior written permission. It consists of the opinions of Gartner’s research organization, which should not be construed as statements of fact. While the information contained in this publication has been obtained from sources believed to be reliable, Gartner disclaims all warranties as to the accuracy, completeness or adequacy of such information. Although Gartner research may address legal and financial issues, Gartner does not provide legal or investment advice and its research should not be construed or used as such. Your access and use of this publication are governed by Gartner’s Usage Policy. Gartner prides itself on its reputation for independence and objectivity. Its research is produced independently by its research organization without input or influence from any third party. For further information, see Guiding Principles on Independence and Objectivity.

Already have a Gartner Account?

Become a client

Learn how to access this content as a Gartner client.