Features
Mock vs passthrough vs disabled
Endpoint mode and server fallback together decide whether Mockphine returns local mocks, forwards to upstream, or skips local mocking for a route.
Purpose
Choose behavior per request path without deleting route definitions.
Where this is used
- MOCK endpoints for stable fake responses.
- PASSTHROUGH for live upstream during partial migration.
- DISABLED when route is intentional no-op locally but still kept in workspace.
- Server fallback for unmatched requests.
Mode behavior matrix
MOCK
Serve endpoint status, headers, body, delay, and failure behavior.
Only requires route identity and response data.
PASSTHROUGH
Forward method/path/query/headers/body to real backend.
Requires real backend URL if this mode can be reached.
DISABLED
Keep rule but do not return local mock response.
Matched traffic is treated like passthrough path.
Setup and prerequisites
- For PASSTHROUGH/DISABLED routes, configure a valid real backend URL.
- Optional endpoint upstream template if path rewrite is needed.
- Server fallback mode only applies when no route matches.
Step-by-step
- Select endpoint and open Settings tab.
- Switch mode to MOCK, PASSTHROUGH, or DISABLED.
- If passthrough is selected, verify endpoint and server templates and URL.
- Send request and confirm served-by in Live View.
Expected result
- MOCK returns local response with local status/body.
- PASSTHROUGH and DISABLED route to upstream and return upstream status/body.
- Fallback STRICT returns 404 Not Mocked; FALLBACK forwards to upstream.
Common issues + fixes
- Passthrough returns 502/504: check backend reachability, hop-by-hop header filtering, and path template variable usage.
- Unexpected passthrough on DISABLED: this is expected; disabled routes intentionally skip MOCK output.
- Start blocked: if backend URL is empty, disable or remove passthrough-capable routes first.
Next, verify route behavior withRequest matchingandLive View.
Endpoint mode selector
Screenshot placeholder
Placeholder: endpoint mode dropdown, passthrough path template, and fallback mode controls.
