Wiremock Standalone Docker

version: "3.8"

services:
  wiremock:
    image: wiremock/wiremock:3.5.2
    container_name: wiremock-standalone
    ports:
      - "8080:8080"
    volumes:
      - ./wiremock:/home/wiremock
    command: ["--global-response-templating"]
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8080/__healthcheck"]
      interval: 10s
      timeout: 5s
      retries: 5
    networks:
      - wiremock-network

  # Example application that uses WireMock
  # app:
  #   build: .
  #   ports:
  #     - "8081:8081"
  #   environment:
  #     - API_BASE_URL=http://wiremock:8080
  #   depends_on:
  #     - wiremock

networks:
  wiremock-network:
    driver: bridge


{
  "request": {
    "method": "DELETE",
    "url": "/api/users/123"
  },
  "response": {
    "status": 403,
    "jsonBody": {
      "error": "Forbidden",
      "message": "Insufficient permissions to perform this action"
    }
  }
}


{
  "request": {
    "method": "GET",
    "urlPattern": "/api/users/.*"
  },
  "response": {
    "status": 200,
    "jsonBody": {
      "id": "{{request.pathSegments.[1]}}",
      "timestamp": "{{now}}",
      "randomUuid": "{{randomValue}}",
      "method": "{{request.method}}"
    },
    "headers": {
      "Content-Type": "application/json",
      "X-Request-Id": "{{randomValue}}"
    }
  }
}


{
  "request": {
    "method": "GET",
    "url": "/api/users/malformed"
  },
  "response": {
    "status": 200,
    "body": "{ invalid json"
  }
}


{
  "request": {
    "method": "GET",
    "url": "/api/users/rate-limit"
  },
  "response": {
    "status": 429,
    "jsonBody": {
      "error": "Too Many Requests",
      "message": "Rate limit exceeded. Please retry after 60 seconds."
    },
    "headers": {
      "Content-Type": "application/json",
      "Retry-After": "60",
      "X-RateLimit-Limit": "100",
      "X-RateLimit-Remaining": "0"
    }
  }
}


{
  "request": {
    "method": "GET",
    "url": "/api/protected"
  },
  "response": {
    "status": 401,
    "jsonBody": {
      "error": "Unauthorized",
      "message": "Invalid or missing authentication token"
    },
    "headers": {
      "Content-Type": "application/json",
      "WWW-Authenticate": "Bearer realm=\"api\""
    }
  }
}


{
  "request": {
    "method": "GET",
    "url": "/api/users/error"
  },
  "response": {
    "status": 500,
    "body": "Internal Server Error",
    "headers": {
      "Content-Type": "text/plain"
    }
  }
}


{
  "request": {
    "method": "GET",
    "url": "/api/users/999"
  },
  "response": {
    "status": 404,
    "jsonBody": {
      "error": "User not found",
      "code": "USER_NOT_FOUND"
    },
    "headers": {
      "Content-Type": "application/json"
    }
  }
}


{
  "request": {
    "method": "GET",
    "url": "/api/users/slow"
  },
  "response": {
    "status": 200,
    "fixedDelayMilliseconds": 5000,
    "jsonBody": {
      "id": "slow",
      "message": "This response was intentionally delayed"
    }
  }
}


{
  "request": {
    "method": "GET",
    "url": "/api/users/123"
  },
  "response": {
    "status": 200,
    "jsonBody": {
      "id": 123,
      "name": "Mario Rossi",
      "email": "mario.rossi@example.com"
    },
    "headers": {
      "Content-Type": "application/json"
    }
  }
}


---
name: wiremock-standalone-docker
description: Provides patterns and configurations for running WireMock as a standalone Docker container. Generates mock HTTP endpoints, creates stub mappings for testing, validates integration scenarios, and simulates error conditions. Use when you need to mock APIs, create a mock server, stub external services, simulate third-party APIs, or fake API responses for integration testing.
allowed-tools: Read, Write, Edit, Bash, Glob, Grep
---

# WireMock Standalone Docker Skill

## Overview

Provides patterns for running WireMock as a standalone Docker container to mock external APIs during integration and end-to-end testing. Runs WireMock as a separate service that simulates real API behavior for testing HTTP clients