8-9 October

Chancery Pavilion Hotel, Bengaluru

Apidays India 2025

8-9 October

Chancery Pavilion Hotel, Bengaluru

Integration Hell [Contract Driven Development – Post 2]

January 17, 2023

Read time: 4 minutes

An image of a woman experiencing microservices integration hell
Published By
LinkedIn
Author
Naresh Jain
Share this page

Article Overview

In my article “Microservices Integration Done Right Using Contract-Driven Development” that was recently published on InfoQ, I explained how the term is often a misnomer. In the context of this article, when we talk about integration testing we are referring to the aspect of verifying the contract compatibility between components.

Integration Tests require the actual components/microservices to be deployed to a common environment. Because of this integration tests are able to verify the connections between these microservices which was never verified until this point since all the constituent microservices of the application were all built in isolation. While tests running in this environment can exercise/verify internal logic of each microservice, that should not be their focus. Nor is it the best use of integration tests. Internal logic can always be verified through tests lower down in the test pyramid. However, this ability to verify connections by virtue of having all constituent components deployed to an environment also is the Achilles heel of integration tests.

Related Articles

spec driven development beyond the first feature with api design first

September 17, 2025

Read time: 4 mins

Spec Driven Development: Beyond the first feature with API Design First

In my previous article, I shared my learnings experimenting with "API Design First with GitHub Spec Kit and Specmatic MCP" with OpenAPI specifications serving as
Read Article
spec driven development api design first with github spec kit and specmatic mcp

September 9, 2025

Read time: 4 mins

Spec Driven Development: API Design First with GitHub Spec Kit and Specmatic MCP

I first came across Specification Driven Development (SDD) when I was exploring AWS Kiro. Coming from an Extreme Programming (XP) background (TDD, small batches, and
Read Article
s

September 2, 2025

Read time: 3 mins

Guardrails for API Development: Guiding Coding Agents with Specmatic MCP

Using API specs like OpenAPI to guide coding agents sounds great. But in agentic mode, these agents build and test on their own — so
Read Article
life of api specmatic

May 20, 2025

Read time: 16 mins

Demystifying API Lifecycle: Unpacking Essential Roles, Responsibilities and Their Challenges 

APIs are the invisible glue of modern digital ecosystems - powering microservices, enabling integrations, and accelerating innovation. But building and scaling successful APIs takes more
Read Article
A hand points at an API icon during a real-world adoption journey of contract-driven development.

March 13, 2023

Read time: 6 mins

Contract-Driven Development – a Real-World Adoption Journey

The story of how a large financial services company adopted contract-driven development. Covering the situation on the ground before adoption and initial skepticism, and how
Read Article
2 parts of a bridge being constructed that are coming together but don't align - representing API mocks that don't align with reality

December 30, 2022

Read time: 3 mins

The trouble with API mocks and stubs [Contract Driven Development – Post 1]

Over the last 6-7 years, I've studied several microservices architecture transformations. What I've realised is a lot of them are not bearing the returns the
Read Article
A group of people integrating microservices using contract-driven development.

December 29, 2022

Read time: 10 mins

Microservices Integration Done Right Using Contract-Driven Development

Contract Driven Development helps us leverage API specifications as executable contracts using Specmatic to shift left the identification of compatibility issues thereby eliminating / reducing
Read Article
spec driven development beyond the first feature with api design first

September 17, 2025

Read time: 4 mins

Spec Driven Development: Beyond the first feature with API Design First

In my previous article, I shared my learnings experimenting with "API Design First with GitHub Spec Kit and Specmatic MCP" with OpenAPI specifications serving as
Read Article
spec driven development api design first with github spec kit and specmatic mcp

September 9, 2025

Read time: 4 mins

Spec Driven Development: API Design First with GitHub Spec Kit and Specmatic MCP

I first came across Specification Driven Development (SDD) when I was exploring AWS Kiro. Coming from an Extreme Programming (XP) background (TDD, small batches, and
Read Article
s

September 2, 2025

Read time: 3 mins

Guardrails for API Development: Guiding Coding Agents with Specmatic MCP

Using API specs like OpenAPI to guide coding agents sounds great. But in agentic mode, these agents build and test on their own — so
Read Article
life of api specmatic

May 20, 2025

Read time: 16 mins

Demystifying API Lifecycle: Unpacking Essential Roles, Responsibilities and Their Challenges 

APIs are the invisible glue of modern digital ecosystems - powering microservices, enabling integrations, and accelerating innovation. But building and scaling successful APIs takes more
Read Article
A hand points at an API icon during a real-world adoption journey of contract-driven development.

March 13, 2023

Read time: 6 mins

Contract-Driven Development – a Real-World Adoption Journey

The story of how a large financial services company adopted contract-driven development. Covering the situation on the ground before adoption and initial skepticism, and how
Read Article
2 parts of a bridge being constructed that are coming together but don't align - representing API mocks that don't align with reality

December 30, 2022

Read time: 3 mins

The trouble with API mocks and stubs [Contract Driven Development – Post 1]

Over the last 6-7 years, I've studied several microservices architecture transformations. What I've realised is a lot of them are not bearing the returns the
Read Article
A group of people integrating microservices using contract-driven development.

December 29, 2022

Read time: 10 mins

Microservices Integration Done Right Using Contract-Driven Development

Contract Driven Development helps us leverage API specifications as executable contracts using Specmatic to shift left the identification of compatibility issues thereby eliminating / reducing
Read Article