Unit Test Wiremock Rest Api

This gives you WireMock patterns for testing REST API integrations without hitting real endpoints. Stub responses, verify request details like headers and query params, and simulate failures (timeouts, 500 errors, malformed JSON). It uses JUnit 5 extensions with dynamic ports to avoid conflicts in parallel test runs. The examples cover basic stubbing and verification, with references to advanced scenarios for body matching and stateful mocking. If you're writing services that call external APIs and want fast, deterministic tests that don't depend on network state or third-party availability, this is the standard approach. Just make sure you keep your stubs in sync with actual API contracts.

skills.sh installs: 3.9K
GitHub stars: 369
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add giuseppe-trisciuoglio/developer-kit --skill unit-test-wiremock-rest-api --agent claude-code

Installs into .claude/skills of the current project.

Files

Unit Testing REST APIs with WireMock

Overview

Patterns for testing external REST API integrations with WireMock: stubbing responses, verifying requests, error scenarios, and fast tests without network dependencies.

When to Use

Testing services calling external REST APIs
Stubbing HTTP responses for predictable test behavior
Testing error scenarios (timeouts, 5xx errors, malformed responses)
Verifying request details (headers, query params, request body)

Instructions

Add dependency: WireMock in test scope (Maven/Gradle)
Register extension: @RegisterExtension WireMockExtension with dynamicPort()
Configure client: Use wireMock.getRuntimeInfo().getHttpBaseUrl() as base URL
Stub responses: stubFor() with request matching (URL, headers, body)
Execute and assert: Call service methods, validate results with AssertJ
Verify requests: verify() to ensure correct API usage