Version: 1.7.0
Administration REST API
#
plugin-admin-apiThe main distribution includes the plugin-admin-api plugin, which provides a REST API that allows to change dynamically the current behavior, change delay time, and another Mocks Server options .
This is very useful when running acceptance tests, as you can change the behavior of the api simply with a request in your tests before
method, for example.
A client for the administration api is also distributed as a separated package: @mocks-server/admin-api-client.
#
OptionsadminApiPath
:<String>
Path for the administration api. Default is "/admin". You should change it only in case there is any conflict with the api you are mocking.adminApiDeprecatedPaths
-<Boolean>
Disables the deprecated "/mocks" api path, which is still enabled by default due to backward compatibility. Used as command line argument, you can disable it using--no-adminApiDeprecatedPaths
(Read the command-line-arguments chapter for further info)
#
Api resourcesAvailable api resources are:
GET
/admin/about
Returns "plugin-admin-api" information.- Response body example:
{ "version": "1.2.0" }
- Response body example:
GET
/admin/behaviors
Returns behaviors collection.GET
/admin/behaviors/:id
Returns an specific behavior.GET
/admin/fixtures
Returns fixtures collection.GET
/admin/fixtures/:id
Returns an specific fixture.GET
/admin/settings
Returns current server settings.- Response body example:
{ "delay": 0, behavior: "foo-behavior", path: "mocks" }
- Response body example:
PATCH
/admin/settings
Changes current server settings.- Request body example:
{ "delay": 3000 }
- Request body example:
Deprecated api resources under "/mocks" api path are also still available.