- 2 min read

Mocking external API with wiremock

img of Mocking external API with wiremock

What happens when you are developing a component that heavily rely on an external API you do not control? Or even worst, that still does not exist. How could you test your component without connecting the external dependency? When we don’t have control over the API that we need to integrate, we need a tool like a “mock server”.

This article will discover and provide a bootstrap project for wiremock. More info: wiremock.org

Quoting from their website:

WireMock is a simulator for HTTP-based APIs. Some might consider it a service virtualization tool or a mock server.

At its core is a Java software that receives HTTP requests with some mapped requests to responses.

TL;DR: https://github.com/adriangalera/docker-compose-wiremock/

Configuring wiremock

Configuring wiremock only consists on defining the requests to be mocked and the response that should be answered on the presence of the mocked request.


One nice way of integrate wiremock with your current testing environment is using it inside docker. There’s this project https://github.com/rodolpheche/wiremock-docker that provides the wiremock service to docker. In order to configure it, you must create the following folder structure:

├── Dockerfile
└── stubs
    ├── __files
   └── response.json
    └── mappings
        └── request.json

The mappings folder contains all the mocked requests definitions and __files contains the response JSON for the mocked requests as shown before


Let’s say we have an external API developed by another team in the company under the host externalapi.com and is not yet finished. The call that our service needs to perform is externalapi.com/v1/resource/resource1 and will respond:

	"hello": "world"

Let’s configure wiremock, so we can start working on our service in parallel with the other team.

  • Configure the request mapping
	"request": {
		"method": "GET",
		"urlPathPattern": "/v1/resource/([a-zA-Z0-9-\\_]*)"
	"response": {
		"status": 200,
		"bodyFileName": "response.json",
		"headers": {
			"Content-Type": "application/json"
  • Configure the response
	"hello": "world"
  • Test it
docker-compose up --build -d
curl http://localhost:7070/v1/resource/resource1
"hello" : "world"

Yay! It worked!

The only missing point is configure the actual component to point to the mocked server. For example with ribbon: