# Mocks

> Start or stop the WireMock API mock server for UI testing and E2E verification.

- Skill: `woocommerce/mocks` (Agent Skill)
- Install (CLI): `npx skillmds@latest add woocommerce/mocks`
- Raw SKILL.md: https://api.skillmd.com/api/skills/woocommerce/mocks/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: woocommerce (https://skillmd.com/u/woocommerce)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/woocommerce/mocks

---


# WireMock Mock Server

Manage the WireMock mock server that serves API responses for UI tests and E2E verification.

Requires **Java** (`brew install openjdk` if missing).

## Start

```bash
./API-Mocks/scripts/start.sh 8282 &
sleep 3
```

Verify it's running:
```bash
curl -s http://localhost:8282/__admin/ > /dev/null && echo "WireMock running on port 8282" || echo "WireMock failed to start"
```

If Java is not installed, report the prerequisite and stop.

## Stop

```bash
./API-Mocks/scripts/stop.sh 8282
```

Uses WireMock's graceful shutdown endpoint. Falls back to kill-by-port if the shutdown endpoint is unreachable:
```bash
kill $(lsof -ti:8282) 2>/dev/null
```

## Details

- **Port**: 8282 (default)
- **Mappings**: `Modules/Sources/APIMocks/Resources/mappings/`
- **Response files**: `Modules/Sources/APIMocks/Resources/__files/`
- **Start script**: `API-Mocks/scripts/start.sh`
- **WireMock**: auto-downloaded on first run (version configured in `start.sh`)