It is time to take the steps that are needed to achieve a successful API Management strategy for your company that allows you to better understand the potential of APIs in your business and what it will take, in terms of API Management, to reach that potential.
To do this, this article will explain step by step the process you need to carry out in order to benefit from the advantages of carrying out a successful API Management strategy in your company. The first thing you’ll need to do is change the way you think about APIs. The old app-to-app contract model is no longer the only way to do this. It is necessary to build or modernize the API Management toolset. To do this, you will need a Governance API model, which brings together the stakeholders of the business and the technique. Next, you’ll need to convert existing capabilities and data into APIs and build an internal API record, so people know where to find them, etc.
Figure 1. 11 Steps to Achieving Successful API Management strategy
11 Steps to Achieving Successful API Management strategy
In order to implement a successful API Management strategy in your company you need to follow the following steps that we will mention below:
Step 1: Change the way you think about APIs to achieve a successful API Management strategy
Managing APIs to make them part of your organization’s business strategy should involve changing how you think about them in the first place. It’s not anyone’s fault, but for many years, IT personnel have viewed the API as a piece of code, a bit of technology.
Then, it’s useful to shift your perspective on how you use APIs. Think of the customer experience first, rather than application features. For example, it’s not so much that you need to integrate your credit card application with an airline mileage account. It’s more like your customer wants to know how many miles he/she earned on their last statement. It’s the same underlying requirement, but viewing it from the customer’s perspective will help you make the API, and its implementation, more valuable to the customer, and thus the organization.
That way, you can align APIs with the services you offer, along with those you plan to provide in the future. Understand how APIs are at the nexus of business, UX, technology, and security. An effective API, as well as any API Management solution, needs to take all these elements into account.
Step 2: Build or Modernize the API Management Toolset
API Management needs the right API management tools. If you don’t have the right tools, you need to either build them or acquire them. Or update what you have. To enable new customer experiences and business strategies, you will need a solution that delivers API Management across the full API lifecycle.
From design to development, deployment, and retirement, the solution must provide effective control over the API. The API Management toolset should enable you to assign API access privileges to specific users or machines. In some cases, this might mean utilizing a third-party authorization scheme like OAuth. In addition to access control, the system has to be able to set usage limits, e.g., user X gets 10,000 API calls per day and so forth. This is necessary to avoid overloading internal systems with unlimited API calls. You also have to be able to monitor the health of your APIs in real time. If an API slows down or goes offline, you need to know—and have a failover ready to go, which is also a capability in most modern API management platforms.
Step 3: Create an Internal API Registry
The APIs need to be discoverable by consumers. To this end, an internal API registry is essential for getting the most out of them. If you already have an API registry, it’s a good idea to think about modernizing it. The goal is to facilitate discovery by internal and external parties. It will be necessary to describe the APIs in the registry in both technical and business terms. Rich detail about the API and its usage potential will help greatly. Done right, the internal API registry will lead to innovative uses of your APIs inside the organization as well as with outside partners. It will also enable reuse of APIs, which drives better Return on Investment (ROI) for API development.
A further benefit of an internal API registry concerns cost and productivity. With an effective registry in use, it becomes possible to allocate expensive development time to new innovative developments, rather than “reinventing the wheel” by building an API that already exists.
Figure 2. Internal API
Step 4: Establish a Governance Model for Managed APIs
The expansion of API use, which is something you hope will happen, necessitates a renewed emphasis on API governance. A governance model for APIs can cover many different subject areas, and they can get complicated. However, keeping things simple, API governance is a matter of determining—and then enforcing— rules that dictate who oversee various aspects of the API program.
For example, an API governance model should cover who can authorize the development of an API, or an application built using APIs. It should specify who gets to decide about access privileges, especially those granted outside the organization. Governance deals with legal contracts and financial chargebacks related to APIs. Governance controls the life cycle, as well as compliance. APIs in your organization must be considered in the context of legal compliance. After all, APIs frequently expose private customer information, so the governance model should specify how customer permissions are secured, and the like.
Step 5: Connect Business and Technical Stakeholders
Modernizing APIs and adopting an advanced API Management solution at an organization is at least partly everyone’s matter. Users and producers of APIs come from different areas of the organization business, and they need to be represented in the API management and governance processes. For instance, the loan payment processing team may not interact much with the marketing or the credit card issuing teams. However, when APIs are involved, these groups may have quite a few things to discuss.
It is also necessary to bring business and technical stakeholders together in API management. The business side of the conversation will be about fulfilling needs for new products and services. The technical side deals with realizing those goals. The two groups can and should collaborate and synergize their efforts. The business team may not understand the full capabilities of APIs, especially when API-driven apps are under consideration.
The technology team, for its part, may not automatically get the full depth of needs on the business side. By aligning business and IT elements of the organization, an organisation can establish a cohesive API strategy that achieves desired business outcomes.
Figure 3. Connect Business and Technical Stakeholders
Step 6: Convert Existing Capabilities and Data to APIs
The step of “building APIs” might seem obvious, but strategic use of APIs requires new approaches to their development. Traditionally, creating an API meant exposing a data source or “wrapping” an existing application function in an API. There is nothing wrong with this, but it’s not a good way to make APIs that can contribute to transformative outcomes.
The new approach should follow a distinct thought process about the API’s purpose and desired functionality for the end user. It’s critical to be user-focused. Who is the user? How will he or she use the application for which this API is being created? Once you have determined the user’s intended experience, you can look at where the required functionality comes from. It’s worth keeping in mind that the user might be a partner firm, rather than a consumer. Partner experience is an important factor to keep in mind when evaluating which capabilities and data should be converted to APIs.
Figure 4. Existing capabilities and data to APIs
This is more of the thinking from the “outside in.” You’re not just taking an app and exposing it. Think about the form factor. For example, if an API is generating a customer’s transaction history, how much of that can you fit on a smartphone screen? This will be the most likely user interface, so it may make sense to limit the number of records being “gotten” for any one cycle.
Step 7: Expose APIs Externally to Build the Ecosystem
As your new APIs become available, you want to expose some of them for external use. You might want to operate your APIs with different consumption models. Some might be free and public. Others could be private and restricted, invisible except to those who know about them. There should be agreed-upon standards of behaviour accompanying any external API use. Such standards can be enforced through policies, such as rate limiting. An API marketplace might be the best way to approach external API consumption.
Exposing APIs externally is a step that requires tight API security. You need to be in control of who has access, with the ability to authenticate users who don’t work for your organization. This may involve identity federation. External APIs need strict rate limiting and monitoring for signs of Denial of Service (DoS) attacks and other threats. The structure of the API itself should be subject to security review and policies, e.g., making sure that an external user cannot access sensitive data through the API.
A related, recommended practice is to let end-users be able to see some aspects of the security that’s protecting them. This will serve to build their confidence that their digital transactions are safe. Reassurance about security is part of the customer experience that prevents defections.
Step 8: Explore Where Building API Products and Mashups Will Benefit the Business
APIs are products, but they can also become parts of other products with even greater functionality. Indeed, one of the great advantages of modern APIs is their potential to be integrated into new, dynamic applications and mashups that orchestrate their operations across business processes. The thing to bear in mind at this point is, as you may know, these sorts of ideas have been tried out before—often with less than stellar results. You need to have the right tools, as well as policies, to be successful with API products and mashups that
invoke APIs.
Step 9: Determine How to Support Different API Security Models
API security is an extensive field of work, so it’s impossible to get into full detail here. The best practice for API Managament at an organization, however, is to be prepared to support different API security models. For example, if your organization practices DevSecOps, which embeds security into the development and releasing (DevOps) process, it is optimal to make API security part of that workflow. At a more granular level, your API Management solution and policies should align with how your organization does cybersecurity, e.g., if your organization has a Security Incident and Event Management (SIEM) solution, then your API Management platform should integrate with it, and so forth. Getting API security right means partnering with the security and compliance teams.
Step 10: Establish Effective Performance and Security Monitoring
API monitoring is a core element of any API Management program at an organization. Monitoring takes two forms: performance and security. Regarding performance, the API Management solution needs to track how APIs are performing in real time. This might be a matter of service quality, e.g., you have a Service Level Agreement (SLA) that specifies an API response time. Or, you might just want to have strong performance to ensure good UX.
At all times, monitoring needs to tell your API managers if there is a problem. If an API is overloaded and sluggish, that needs to be handled. Or, if an API fails altogether, system owners must know immediately so they can remediate accordingly.
APIs are attractive for malicious actors, as they promise access to systems and data behind the firewall. As a result, API behaviour has to be closely watched for anomalies that could indicate an attack is underway. The signs of an attack might be subtle.
For example, if an authorized user invokes the API a thousand times in an hour in the middle of the night, that suggest an account takeover. The API Management platform should connect with security operations (SecOps) systems and incident response workflows to ensure a suitable response to a detected threat such as this. Let’s learn the last step of the 11 steps to achieving Successful API Management strategy.
Figure 5. Effective Performance and Security Monitoring
Step 11: Create a Center of Excellence (COE) and/or Program Office
It is a highly recommended practice to establish an API Center of Excellence (COE) or program office. The structure and size of this center will evolve over time. In the beginning, as the API Management solutions and new policies are introduced, it will likely be larger. Over time, it will shrink to its permanent size. The goal of the COE or program office is to create a central location (either digital or physical) where any stakeholder who touches APIs can get answers about how to do things, policies, security, compliance, and other relevant API practices. The COE can serve as the entity that validates API designs and signs off on changes in security policy, to name just two examples of the many roles it can play.
The COE or program office can also help everyone involved understand their Total Cost of Ownership (TCO) and ROI for any aspect of their API program. The center can explain to anyone who needs to know how to do real-world API implementations. Working this way, the center can help stakeholders understand how to prove the value of their proposed projects and ideas. If your organization has struggled with APIs in the past, a COE or program office provides a good mechanism for correcting old, wrong assumptions about how APIs work and what they can do. It can help people see their full business potential. That’s now the last step of the 11 steps to achieving Successful API Management strategy.
Figure 6. Center of Excellence
If you are thinking of implementing an API management strategy in your company, we can help you today, contact us.
Reduce costs, complexity and technical debt with your API portfolio
Start making APIs work for your business, talk to our experts!
contact us about api management