@mocks-server/plugin-admin-api

Mocks Server plugin providing a REST API for administration

Usage no npm install needed!

<script type="module">
  import mocksServerPluginAdminApi from 'https://cdn.skypack.dev/@mocks-server/plugin-admin-api';
</script>

README

Build status Coverage Status Quality Gate

Renovate Last commit Last release

NPM downloads License

Mocks Server"> Mocks Server Plugin Admin Api

Plugin for Mocks Server that provides an API REST that allows to change the current behavior, change delay time, and another Mocks Server options.

This is very useful when running acceptance tests, as you can change the current mock simply with a HTTP request in the before method of your tests, for example.

A client for the administration api is also distributed as a separated package: @mocks-server/admin-api-client.

Usage

This plugin is included in the main distribution of the Mocks Server project, so you can refer to the official documentation website.

Options

  • adminApiPath (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.

Read more about how to set options in Mocks Server here.

API Resources

Available api resources are:

  • GET /admin/about Returns "plugin-admin-api" information.
    • Response body example: { "version": "1.2.0" }
  • GET /admin/mocks Returns mocks.
  • GET /admin/mocks/:id Returns a specific mock.
  • GET /admin/routes Returns routes collection.
  • GET /admin/routes/:id Returns a specific route.
  • GET /admin/routes-variants Returns routes variants collection.
  • GET /admin/routes-variants/:id Returns a specific route variant.
  • GET /admin/mock-custom-routes-variants Returns an array of currently custom routes variants ids.
  • POST /admin/mock-custom-routes-variants Defines a route variant to be used by current mock.
    • Request body example: { "id": "users:error" }
  • DELETE /admin/mock-custom-routes-variants Restore routes variants to those defined in current mock.
  • GET /admin/settings Returns current server settings.
    • Response body example: { "delay": 0, mock: "foo-mock", path: "mocks" }
  • PATCH /admin/settings Changes current server settings.
    • Request body example: { "delay": 3000 }
  • GET /admin/alerts Returns current alerts.
  • GET /admin/alerts/:id Returns a specific alert. The alert id is equivalent to the alert context (read the developing plugins chapter for further info about alerts).

v1.x deprecated api resources are also still available under the /legacy path.

Contributing

Contributors are welcome. Please read the contributing guidelines and code of conduct.