To build a successful API programme, begin by recognising APIs’ pivotal role in modern digital-first organisations, regardless of whether you operate as a software-as-a-service entity or an enterprise. The process involves three critical steps that lay the foundation for an effective and scalable API initiative:
Reading list
Learn more about API platform management and teams here.
STEP 1
Select the appropriate API governance model
API governance models come in various forms, from centralisation to distribution, each with benefits and challenges. Centralised governance involves a single central team overseeing all aspects of API governance, providing high consistency but potentially slowing development. Federated governance distributes responsibilities across multiple teams, offering autonomy within centrally defined standards. Distributed governance grants complete API control to individual teams, ensuring flexibility but risking inconsistency. Hybrid models combine aspects of centralisation and decentralisation, while automated governance uses tools to enforce policies. Choose the model best suited to your organisation’s size and structure, and be prepared to evolve as you grow.
STEP 2
Establish your API engagement models
Engaging with your API community is essential for successful API design and implementation. Implement various engagement models to address teams’ needs effectively. With open channels like Slack or Teams, community support offers quick answers through shared experiences. Office hours provide weekly open discussions where teams can ask questions and receive solutions. API design sessions focus on specific API challenges and can be requested or scheduled during office hours. API design reviews involve more comprehensive feedback, requiring teams to share design artefacts. For high-profile initiatives, API design facilitation provides in-depth, hands-on design guidance. Start with one or two engagement models and expand as your API programme develops.
STEP 3
Scale through federated API coaching
For larger organisations, scaling your API governance and engagement models is crucial. Implement a federated API coaching model alongside governance automation. Federated API coaches support specific business units or domain areas, reducing wait times associated with centralised governance. These coaches offer domain-specific knowledge, providing more meaningful insights than a central group. A federated API coaching programme promotes an API-first mindset, addresses design issues earlier, ensures adherence to standards, reduces rework and preserves institutional memory. Consider implementing an API coach programme as part of your scaling strategy, tailoring it to your organisation’s size and needs.
Chapter recap
The three steps of building an API programme are:
By following these three essential steps - selecting the suitable governance model, establishing effective engagement models, and scaling through federated API coaching - you can build a robust and successful API programme that aligns with your organisation’s goals, fosters collaboration, and drives innovation. Now, let’s look at how to streamline your teams’ day-to-day operations for maximum impact.
- Select the appropriate API governance model
- Establish API engagement models
- Scale through federated API coaching