16 Enterprise Architecture Best Practices | digitalML

16 Common Architecture Best Practices

API Strategy

16 Common Architecture Best Practices

·  3 Min Read

16 best practices for world-class enterprise architecture and a mature API program.

Digital leaders are distinguished by how they structure their IT landscape. The best ones, connect business and IT and enable the flexibility to integrate next gen architecture as needed.

We’ve worked with our customers on developing a standardized best practice architecture that integrates with an existing IT landscape, while providing the ability to integrate or move to new platforms as needed. By positioning the ignite platform upstream of CI/CD systems, you’re able to house standardized API Designs and Specifications in one place for discoverability and reusability, while using those Designs to drive your various runtime environments.


Enterprise Architecture Best Practices:

1. ignite as the initial and single point of API creation and integrated management

BENEFIT: ignite maintains an up to date holistic and abstracted catalog of APIs and Services in lifecycle states ranging from blueprint through retired. APIs are created in a governed manner producing a consistent results.

2. ignite as the API and API metadata system of record

BENEFIT: Avoid integrating separate repositories and ensure a correct, complete, and up to date catalog with alignment to capabilities, systems and experiences. A single repository maintaining APIs across lifecycles and versions for a single source of truth.

3. Generate API Specification documents

BENEFIT: Create consistent OpenAPI and WSDLs through generation from one source and one configuration. Consistent Specification representations makes API build and consumption easier.

4. API discoverability

BENEFIT: ignite manages the holistic API and Service catalog and becomes the source of truth for discovering APIs which in turn enables easier and more frequent reuse with corresponding cost reduction.

5. Use ignite to create and manage reusable data models

BENEFIT: A centralized store of information models lets APIs be defined in a semantically and structurally consistent manner with reduced effort during API design.

6. API abstraction

BENEFIT: Define APIs without being tied to current technology choices. Enable technology generation changes (i.e. SOAP to REST) through regeneration not recreation of the APIs.

7. Use ignite to create and manage reusable data models

BENEFIT: A centralized store of information models lets APIs be defined in a semantically and structurally consistent manner with reduced effort during API design.

8. Organize your API catalog by business and technical building blocks

BENEFIT: Reduces analysis time, increases adoption and value realization, ties directly to driving or delivering experiences, provides coverage reporting for usage and investments, enables a federated model with greater flexibility.

9. Map system of record applications, business capabilities and taxonomies to API Designs and Specifications

BENEFIT: Provides end to end lineage and impact analysis; ability to group and discover based on business and technical needs; accelerates identification and deployment of next gen architecture.

10. Automated enterprise API Standards, Policies, Security to create consistent and complete API Designs and Specifications

BENEFIT: Self service governance and enterprise standards are built into the design and build process; adds to developer productivity (along with enabling other roles across the API lifecycle) & reduces duplication and snowflakes

11. Git integration for controlled downstream deployment

BENEFIT: Deploy generated artifacts from ignite to Git and other SCMs where changes are versioned, auditable and recoverable.

12. CI/CD for decoupled integration

BENEFIT: Integrate with API Management, Developer Portal, ESBs and other enterprise technologies through a DevOps pipeline rather than through direct integration. Achieves component runtime decoupling, leverages existing tooling and expertise, and enables an open-ended set of integrations.

13. CI/CD pipeline to create and deploy API proxies, dev portal entries, testing endpoints, and other artifacts

BENEFIT: Centralize integration logic in the pipeline where it can be controlled and updated independently by the enterprise. Once code is pushed to Git, it can then also be enhanced through standard development practices, and changes can be pushed back into Git and deployed through the standard DevOps process.

14. Templates to generate technical artifacts

BENEFIT: Generation capability produces consistent technical outputs based on governed metadata values. Good candidates for generation include configured API proxies, Dev Portal entries and stubbed API implementation code.

15. API Management integration to capture consumers dependencies

BENEFIT: API consumption relationships are key to knowing which APIs can be deprecated and retired. Integration with the Dev Portal should capture new applications (consumers) and new Application-API consumption relationships once those have been approved.

16. Identify and prioritize APIs and Products

BENEFIT: Translate business capability models describing business behavior and priorities into service activity. Ensures a business value focused approach while coordinating multiple domains, programs and interests. Links expected KPIs to realized.


ignite version 7 free webinar

About the Author

Learn the Best API Practices and Get the Latest ignite Updates

What can we help you find?

Upcoming Webinar: How a connected catalog is helping large enterprises meet the evolution of an API strategy

Join us for a 30 minute conversation with digitalML’s CEO, Jeremy Sindall and CTO, Sayee Bapatla as they have a conversation around the vision of large enterprises, the path to get there, where connected catalogs vs dev portals and marketplaces fit in, and examples from leaders on what frameworks they’re building.

Use of cookies

We use cookies to make the website optimal and to continuously improve it. By continuing to use the site, you consent to the use of cookies. Please refer to the privacy policy for more information.