Multiple responses
For each route, multiple responses can be defined (status, body, and headers) and triggered using a set of rules. There is always at least one response when you create a new route. You can modify it and add more responses but you can never delete the last route response.
Adding or duplicating a response
To add a new response to your route, click on the "plus" icon next to the responses list:
You can also duplicate an existing route response by clicking on the "copy" icon on the right:
Everything will be copied to the new response: documentation, file/body, headers and rules.
Route responses precedence
Route responses order define the order in which the rules are interpreted. You can easily change the default response by reordering the responses menu with a drag and drop:
Default route response
Without rules or when a request does not match the one you defined, the default response will always be the one marked with the blue flag. You can easily change the default response by clicking on the grey flags in the menu:
Random route response
Mockoon can serve the route responses randomly (200, 500, 404) to simulate an unpredictable behavior.
To activate this option, click on the "shuffle" icon next to the response list:
⚠️ When this option is active, the default response and all the rules defined on this route will be ignored. Also, this option cannot be selected in addition to the sequential responses option below.
Sequential route response
Mockoon can serve the route responses sequentially (200 → 500 → 404). Mockoon will serve all the responses one after the other and restart at the beginning. The sequence is reset when restarting the server.
To activate this option, click on the "repeat" icon next to the response list:
⚠️ When this option is active, the default response and all the rules defined on this route will be ignored. Also, this option cannot be selected in addition to the random responses option above.
Fallback mode
When the fallback mode is enabled, Mockoon will automatically pass the request to the proxy (or the next route, see below) when none of the responses' rules match.
To activate this option, click on the "fallback" icon next to the response list:
Behind the scene, the server will automatically jump to the next route in the order they were declared and, ultimately, to the proxied server. It allows to create complex setups where a wildcard or parameterized route contains rules to protect the access to other routes:
GET /users/* --> Authorization header required
GET /users/:id --> No rules
💡 Header over to our "Global routes with rules" documentation section to learn more about this feature.
⚠️ When this option is active, the default response will be ignored. Also, this option cannot be selected in addition to the other response options above and could result in a 404 if the proxy is not enabled.