Introduction

Welcome to the Mock Services section of the BlazeMeter API Reference! This reference provides information on accessing our API endpoints to automate the creation of mock services and transactions for your services.

After verifying your application server is functioning as expected, you're ready to move on to simulating some tests. BlazeMeter CT's Mock Services allow you to test even when you don't have access to a full test environment. You can run a mock service to deploy transactions, which are typically a subset of transactions in a particular service.

Once a mock service is created and running, you can associate it to your test, embed it in your test scripts, or provide it during test execution.

This API reference uses the following conventions for your convenience:

Language bindings are available in cURL. You can view the code examples and JSON responses in the dark area to the right.

Please be aware that all examples are built with Mac/Linux systems. If you are using Windows systems, you will need to change all single quotes (') to double quotes (").

Links to the API explorer are provided in the following format: Swagger UI. To use Swagger, you must first log in to a.blazemeter.com to establish authentication. If you need an account, signup for a free account (first and last name, and a valid email address are required).

Overview

Your Account provides access to different levels of the API:

Workspaces: Workspaces are the highest level container within an account. They contain Services, Mock Services, Transactions, and Tags. A Service has one or more Mock Services and Transactions. Each Mock Service uses one or more Transactions. You can assign Tags to categorize Transactions and Services for easy filtering and searching. Each workspace has its own ID, known as a workspaceId, which will be required for use in the APIs.

The following figure illustrates the relationship between the components.

BlazeMeter Mock Services API Overview.png

Authorization Using Basic Authentication

Authorization

curl 'https://a.blazemeter.com/api/v4/user' \
    --user 'api_key_id:api_key_secret'

Response 200 OK

{
  "api_version": 4,
  "error": null,
  "result": {
    "id": 123456,
    "email": "my.name@my_email.com",
    "access": 1522676762,
    "login": 1521724222,
    "firstName": "my",
    "lastName": "name",
    "timezone": 0,
    "enabled": true,
    "roles": [
      "user",
      "new-billing",
      "authenticated"
    ]
    }
  }
}

API Explorer: /user

To use the BlazeMeter API, pass your BlazeMeter API key using Basic Authentication (Basic Auth) credentials. These credentials contain a Key ID and a Secret Key:

id:secret

For example: f817e22f1526b048799f75da:7641251982b983cfd92b5a25fa97cd3ee9e21920f21d8b14cd705831826935723f3033f0

If using a tool like Postman, select 'Basic Auth' as the authentication type. From your BlazeMeter API key, enter your api_key_id as the Username and api_key_secret as the Password.

All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail. In the code sample, replace 'api_key_id:api_key_secret' with your credentials.

All API examples used in this documentation use api_key_id and api_key_secret to denote the API Key ID and Secret Key. Just replace these values with your crendentials in each example.

Create the API Key

Use the linked BlazeMeter article to create your API key.

Mock Service Service REST API

Create a Service

To create a Service in your Workspace, you need to know your Workspace identifier. The sample code uses a workspaceId of 123456. Use the actual ID value of your workspace.

The response contains a Service identifier that you should note down. You will need the serviceID when you want to configure, deploy, or delete this Service later.

Create a Service Minimum Configuration Sample


curl 'https://mock.blazemeter.com/api/v1/workspaces/123456/services' \
    -X POST \
    -H 'accept: */*' \
    -H 'authorization: Basic Aa1Bb2Cc3Dd4Ee5Ff6Gg7Hh8Ii9Jj0Aa1Bb2Cc3Dd4Ee5Ff6' \
    -H 'Content-Type: application/json' \
    -d '{ "description": "This service handles foo.", "name": "My Foo Service"}'

The following parameters are the base parameters required to create Service.

Create a Service Request Attributes

Create a Service Minimum Configuration Sample POST Body (JSON)

{
  "description": "This service handles foo.",
  "name": "My Foo Service"
}

Response 201 Created

{
  "apiVersion": 1,
  "error": null,
  "result": {
    "id": 1645,
    "name": "My Foo Service",
    "description": "This service handles foo.",
    "created": 1563897852,
    "updated": 1563897852,
    "createdBy": "someone@example.com",
    "updatedBy": "someone@example.com"
  },
  "requestId": "ec0e40cf720bdbc4"
}

Attributes

workspaceId string
required

The Workspace identifier
description string

Description of the Service
name string

The name of the Service

Get All Services

To get all Services of a Workspace, you need to know your Workspace identifier. The sample code uses a workspaceId of 123456. Use the actual ID value of your Workspace.

Minimum Parameters for getting all Services

Get All Services Minimum Configuration Sample


curl 'https://mock.blazemeter.com/api/v1/workspaces/123456/services?limit=5&skip=0&sort=name' \
    -X GET  \
    -H 'accept: */*' \
    -H 'authorization: Basic Aa1Bb2Cc3Dd4Ee5Ff6Gg7Hh8Ii9Jj0Aa1Bb2Cc3Dd4Ee5Ff6'

The following parameters are the base parameters required to get all Services.

Get All Services Request Attributes

Response 200 OK

{
  "apiVersion": 1,
  "error": null,
  "result": [
    {
      "id": 1619,
      "name": "Some Service",
      "description": null,
      "created": 1563893805,
      "updated": 1563893805,
      "createdBy": "someone@example.com",
      "updatedBy": "someone@example.com"
    },
    {
      "id": 1618,
      "name": "Some other Service",
      "description": "A service that serves as an example",
      "created": 1563893804,
      "updated": 1563893804,
      "createdBy": "someone@example.com",
      "updatedBy": "someone@example.com"
    }
  ],
  "requestId": null,
  "limit": 5,
  "skip": 0,
  "total": 2
}

Attributes

limit integer

Number of results per page
name string

The Service name to filter by
skip integer

Number of initial results to skip
sort string

The column name to sort by: `id`, `name`, or `description`
workspaceId integer
required

The Workspace identifier

Get Service by ID

To get a Service of your Workspace, you need to know your Workspace identifier and the Service identifier. The sample code uses a serviceId of 123 and a workspaceId of 123456. Use the actual ID values of your Workspace and Service.

Minimum Parameters for Getting a Service by its ID

Get a Service Minimum Configuration Sample


curl 'https://mock.blazemeter.com/api/v1/workspaces/123456/services/123' \
    -X GET \
    -H 'accept: */*' \
    -H 'authorization: Basic Aa1Bb2Cc3Dd4Ee5Ff6Gg7Hh8Ii9Jj0Aa1Bb2Cc3Dd4Ee5Ff6'

The following parameters are the base parameters required to get a Service by its ID.

Get a Service Request Attributes

Response 201 Created

{
  "apiVersion": 1,
  "error": null,
  "result": {
    "id": 123,
    "name": "My Foo Service",
    "description": "This service handles foo.",
    "created": 1563897852,
    "updated": 1563897852,
    "createdBy": "someone@example.com",
    "updatedBy": "someone@example.com"
  },
  "requestId": "d1cfe5c67b2ed26f"
}

Attributes

serviceId string
required

The Service identifier
workspaceId integer
required

The Workspace identifier

Update a Service

To update the name and description of an existing Service in your Workspace, you need to know your Workspace identifier and the Service identifier. The sample code uses a serviceId of 123 and a workspaceId of 123456. Use the actual ID values of your Workspace and Service.

Minimum Parameters for Updating a Service

Update a Service Minimum Configuration Sample


curl 'https://mock.blazemeter.com/api/v1/workspaces/123456/services/123' \
    -X PUT \
    -H 'accept: */*' \
    -H 'authorization: Basic Aa1Bb2Cc3Dd4Ee5Ff6Gg7Hh8Ii9Jj0Aa1Bb2Cc3Dd4Ee5Ff6' \
    -H "Content-Type: application/json" \
    -d '{ "description": "A service that handles foo", "id": 1645, "name": "My foo service"}'

The following parameters are the base parameters required to update a Service.

Update a Service Request Attributes

Response 201 Created

{
  "apiVersion": 1,
  "error": null,
  "result": {
    "id": 123,
    "name": "My Foo Service",
    "description": "This service handles foo.",
    "created": 1563897852,
    "updated": 1563897852,
    "createdBy": "someone@example.com",
    "updatedBy": "someone@example.com"
  },
  "requestId": "d1cfe5c67b2ed26f"
}

Attributes

serviceId integer
required

The Service identifier
workspaceId integer
required

The Workspace identifier
description string
required

The new description of the updated Service
name string
required

The new name of the updated Service

Tag REST API

You can categorize Mock Service Transactions and Services by applying Tags of your choice. These tags are available in searches and filters.

Tag names can be provided in two ways:

Using comma separated query parameters. In this case, tags are added for all transactions in the request.
Example: tags=tag1,tag2
Specified inside a transaction in the request body, as collection of strings. In this case, tags are created only for this particular transaction.
Example: "tags": [“tag1", “tag2"]

New tags are created if they are used in requests and do not exist yet.

Create a Tag

You can use tags when you search and filter Transactions or Services. The creation response contains a tag identifier that you should note down. You will need the tagID when you want to configure, deploy, or delete this tag later.

New tags are also created if they are used in requests and do not exist yet.

Create a Tag Minimum Configuration Sample


curl 'https://mock.blazemeter.com/api/v1/tags' \
   -X POST \
   -H 'accept: */*' \
   -H 'Content-Type: application/json' \
   -d '{ "description": "payment service category", "name": "pay"}'

The following parameters are the base parameters required to create a tag.

Create a Tag Request Attributes

Response 201 Created

{
  "apiVersion": 1,
  "error": null,
  "result": {
    "id": 888,
    "name": "pay",
    "description": "payment service category",
    "created": 1564147307,
    "updated": 1564147307,
    "createdBy": "somebody@example.com",
    "updatedBy": "somebody@example.com"
  },
  "requestId": "acb25df0e22ec097"
}

Attributes

description string

The description of the tag category
name string

The name of the tag that can be used in searches and filters

Get All Tags

You can use tags when you search and filter Transactions or Services.

Minimum Parameters for getting all tags

Get All Tags Minimum Configuration Sample


curl 'https://mock.blazemeter.com/api/v1/tags?limit=10&skip=0&sort=name' \
   -X GET \
   -H 'accept: */*'

The following parameters are the base parameters required to get all tags.

Get All Tags Request Attributes

Response 200 OK

{
  "apiVersion": 1,
  "error": null,
  "result": [
    {
      "id": 163,
      "name": "prod",
      "description": null,
      "created": 1563893805,
      "updated": 1563893805,
      "createdBy": "somebody@example.com",
      "updatedBy": "somebody@example.com"
    },
    {
      "id": 162,
      "name": "test",
      "description": null,
      "created": 1563893805,
      "updated": 1563893805,
      "createdBy": "somebody@example.com",
      "updatedBy": "somebody@example.com"
    },
    {
      "id": 203,
      "name": "dev",
      "description": "tag description",
      "created": 1563980513,
      "updated": 1563980513,
      "createdBy": "somebody@example.com",
      "updatedBy": "somebody@example.com"
    }
  ],
  "requestId": null,
  "limit": 10,
  "skip": 0,
  "total": 3
}

Attributes

limit integer

The number of results per page
skip integer

The number of initial results to skip
sort string

The column name to sort by: id, name, or description

Get Tag by ID

To get a tag, you need to know either the tag identifier or its name. The sample code uses a tagId of 888. Use the actual ID values of your tag.

Minimum Parameters for Getting a Tag by ID

Get Tag by ID Minimum Configuration Sample

curl 'https://mock.blazemeter.com/api/v1/tags/888' \
    -X GET \
    -H 'accept: */*'

The following parameters are the base parameters required to get a tag by its ID.

Get Tag by ID Request Attributes

Response 200 OK

{
  "apiVersion": 1,
  "error": null,
  "result": {
    "id": 888,
    "name": "pay",
    "description": "payment service category",
    "created": 1563980513,
    "updated": 1563980513,
    "createdBy": "somebody@example.com",
    "updatedBy": "somebody@example.com"
  },
  "requestId": "ee47a7b219e3a9e5"
}

Attributes

tagId integer
required

The tag identifier

Get Tag by Name

To get a tag, you need to know either the tag name or its identifier. The sample code uses a name of pay. Use the actual name of your tag.

Minimum Parameters for Getting a Tag by Name

Get Tag by Name Minimum Configuration Sample

curl 'https://mock.blazemeter.com/api/v1/tags/name/pay' \
    -X GET \
    -H 'accept: */*'

The following parameters are the base parameters required to get a tag by its name.

Get Tag by Name Request Attributes

Response 200 OK

{
  "apiVersion": 1,
  "error": null,
  "result": {
    "id": 288,
    "name": "pay",
    "description": "payment service category",
    "created": 1564147307,
    "updated": 1564147307,
    "createdBy": "somebody@example.com",
    "updatedBy": "somebody@example.com"
  },
  "requestId": "ee47a7b219e3a9e5"
}

Attributes

name string
required

The tag name

Update a Tag

To update the name or description of an existing tag, you need to know the tag identifier. The sample code uses a tagId of 888. Use the actual ID value of your tag.

Minimum Parameters for Updating a Tag

Update a Tag Minimum Configuration Sample


curl 'https://mock.blazemeter.com/api/v1/tags/888' \
   -X PUT \
   -H 'accept: */*' \
   -H 'Content-Type: application/json' \
   -d '{ "description": "task tracker", "id": 888, "name": "tasks"}'

The following parameters are the base parameters required to update a tag.

Update a Tag Request Attributes

Response 201 Created

{
  "apiVersion": 0,
  "error": "string",
  "limit": 0,
  "link": "string",
  "requestId": "string",
  "result": {
    "created": "2019-07-26T13:42:48.750Z",
    "createdBy": "somebody@example.com",
    "description": "task tracker",
    "id": 888,
    "name": "tasks",
    "updated": "2019-07-26T13:42:48.750Z",
    "updatedBy": "somebody@example.com"
  },
  "skip": 0,
  "total": 0
}

Attributes

description string
required

The description of the tag
id integer
required

The identifier of the tag
name string

The name of the tag

Delete Tag

To delete a tag, you need to know the tag identifier. The sample code uses a tagId of 888. Use the actual ID value of your tag.

Minimum Parameters for Deleting a Tag

Delete a Tag Minimum Configuration Sample

curl 'https://mock.blazemeter.com/api/v1/tags/888' \
    -X DELETE \
    -H 'accept: */*'

The following parameters are the base parameters required to delete a tag.

Delete a Tag Request Attributes

Response 200 OK

{
}

Attributes

tagId integer
required

The tag identifier

Transaction API

A Transaction is a request/response pair that is associated with a given Service. A Transaction contains one or more request patterns and hard-coded responses. You typically create a custom catalog of mock Transactions for each Service. When you create a Mock Service, you assign Transactions from your catalog to the Mock Service.

Transaction Types (DSL)

The dsl is the object that stores properties of Transactions. Supported dsl type keys are GENERIC_DSL, CODESV_DSL, WIREMOCK_DSL, HAR_DSL, SWAGGER2_DSL, SWAGGER3_DSL, TAURUS_RECORDING, RR_PAIR. For more information, see Adding Transactions.

The easiest way to create a valid dsl for an API call is to create a Transaction in the web interface and copy and paste the response.

Create Transaction

To create a Transaction, you need to know your Workspace identifier and the Service identifier. The sample code uses a serviceId of 123 and a workspaceId of 123456. Use the actual ID values of your Workspace and Service.

The response contains an identifier that you should note down. You will need this transactionID when you want to configure, deploy, or delete this Transaction later.

The easiest way to create a Transaction is through the web interface, from where you can also copy and paste a valid default dsl. For more details how to write a dsl, see dsl in the Appendix.

Create a Transaction Minimum Configuration Sample


curl 'https://mock.blazemeter.com/api/v1/workspaces/26208/transactions?serviceId=1645' \
  -X POST \
  -H 'accept: */*' \
  -H 'Content-Type: application/json' \
  -d '{ "transactions": [ { "name": "Transaction from API", "description": "Transaction created by API", "tags": [ "my_tag" ], "dsl": { "priority": 0, "requestDsl": { "method": "POST", "url": { "key": "url", "matcherName": "equals_url", "matchingValue": "http://www.example.com" }, "headers": [ { "key": "header1", "matcherName": "contains", "matchingValue": "value1" } ], "queryParams": [ { "key": "q1", "matcherName": "contains", "matchingValue": "q_value1" } ], "cookies": [ { "key": "cookie1", "matcherName": "contains", "matchingValue": "c_value1" } ], "credentials": { "username": "joe user", "password": "p455w0rd" }, "body": [ { "matcherName": "matches_json", "matchingValue": "JFsnbWVudSddWydpZCdd" } ] }, "responseDsl": { "status": 200, "statusMessage": "HTTP/1.1 200 OK", "headers": [ { "name": "Content-Type", "value": "text/plain; charset=UTF-8" } ], "binary": false, "content": "SGVsbG8gd29ybGQhCg==", "charset": "UTF-8" } } } ] }'

The following parameters are the base parameters required to create a Transaction.

Create a Transaction Request Attributes

Response 200 OK

{
  "apiVersion": 0,
  "error": "string",
  "limit": 0,
  "link": "string",
  "requestId": "string",
  "result": {
    "description": "string",
    "dsl": {
      "array": true,
      "bigDecimal": true,
      "bigInteger": true,
      "binary": true,
      "boolean": true,
      "containerNode": true,
      "double": true,
      "float": true,
      "floatingPointNumber": true,
      "int": true,
      "integralNumber": true,
      "long": true,
      "missingNode": true,
      "nodeType": "ARRAY",
      "null": true,
      "number": true,
      "object": true,
      "pojo": true,
      "short": true,
      "textual": true,
      "valueNode": true
    },
    "id": 0,
    "link": "string",
    "name": "string",
    "serviceId": 0,
    "serviceName": "string",
    "tags": [
      "string"
    ]
  },
  "skip": 0,
  "total": 0
}

Attributes

workspaceId integer
required

The Workspace identifier
serviceId integer
required

The Service identifier
name string
required

The name of this transaction
description string

An optional description that helps you identify this transaction
tags array

An optional array of custom tags to help you identify this transaction. New tags are created if they do not exist yet
dsl object
required

The dsl is the object that stores properties of Transactions. For details, see dsl in the Appendix.

Create Transaction From Sources

To create a Transaction from a source file, you need to know your Workspace identifier and the Service identifier. The sample code uses a serviceId of 123 and a workspaceId of 123456. Use the actual ID values of your Workspace and Service.

The creation response contains an identifier that you should note down. You will need the transactionID when you want to configure, deploy, or delete this Transaction later.

Minimum Parameters for creating a Transaction

Create a Transaction Minimum Configuration Sample


curl 'https://mock.blazemeter.com/api/v1/workspaces/123456/transactions' \
   -X POST \
   -H 'accept: */*' \
   -H 'Content-Type: multipart/form-data' \
   -F 'serviceId=123' \
   -F 'verbose=true'

The following parameters are the base parameters required to create a Transaction.

Create a Transaction Request Attributes

Response 200 OK

{
  "apiVersion": 0,
  "error": "string",
  "limit": 0,
  "link": "string",
  "requestId": "string",
  "result": [
    {
      "description": "string",
      "dsl": {
          "priority": 1,
          "requestDsl": {
            "method": "GET",
            "host": "http://miurl.com.ec",
            "path": "",
            "url": {
              "key": "url",
              "matcherName": "equals_url",
              "matchingValue": "miurl.com.ec"
            },
            "headers": [],
            "queryParams": [],
            "cookies": [],
            "credentials": {},
            "body": []
          },
          "responseDsl": {
            "status": 200,
            "statusMessage": "OK",
            "proxyUrl": "",
            "headers": [],
            "binary": false,
            "contentType": "json",
            "content": "",
            "charset": "UTF-8"
          }
        } ,
      "id": 0,
      "link": "string",
      "name": "string",
      "serviceId": 123,
      "serviceName": "string",
      "tags": [
        "string"
      ]
    }
  ],
  "skip": 0,
  "total": 0
}

Attributes

workspaceId integer
required

The Workspace identifier
serviceId integer
required

The Service identifier

Import Transactions

Use this API to upload files of Transactions to lists of generic DSLs that can be used in BlazeMeter. Supported file formats are .json, .yml, .yaml, .har, .zip.

Minimum Parameters for Importing Transactions

Import Transactions Minimum Configuration Sample

curl 'https://mock.blazemeter.com/api/v1/transactions/convert?verbose=true' \
   -X POST \
   -H 'accept: */*' \
   -H 'Content-Type: multipart/form-data' \
   -F 'file=@my-swagger.json;type=text/json'

The following parameters are the base parameters required to import Transactions.

Import Transactions Request Attributes

Response 200 OK

{
  "apiVersion": 0,
  "error": "string",
  "limit": 0,
  "link": "string",
  "requestId": "string",
  "result": [
    {
      "nativeId": "string",
      "priority": 0,
      "requestDsl": {
        "body": [
          {
            "key": "string",
            "matcherName": "string",
            "matchingValue": "string"
          }
        ],
        "cookies": [
          {
            "key": "string",
            "matcherName": "string",
            "matchingValue": "string"
          }
        ],
        "credentials": {
          "password": "string",
          "username": "string"
        },
        "headers": [
          {
            "key": "string",
            "matcherName": "string",
            "matchingValue": "string"
          }
        ],
        "host": "string",
        "method": "string",
        "path": "string",
        "queryParams": [
          {
            "key": "string",
            "matcherName": "string",
            "matchingValue": "string"
          }
        ],
        "url": {
          "key": "string",
          "matcherName": "string",
          "matchingValue": "string"
        }
      },
      "responseDsl": {
        "binary": true,
        "charset": "string",
        "content": "string",
        "contentType": "JSON",
        "headers": [
          {
            "name": "string",
            "value": "string"
          }
        ],
        "proxyUrl": "string",
        "status": 0,
        "statusMessage": "string"
      }
    }
  ],
  "skip": 0,
  "total": 0
}

Attributes

verbose boolean

Whether to include extra elements, such as Headers, when importing and converting the transactions from the file

Get Transaction

To get a Transaction, you need to know your Workspace identifier and the Transaction identifier. The sample code uses a transactionId of 77 and a workspaceId of 123456. Use the actual ID values of your Workspace and Mock Service template.

Minimum Parameters for getting a Transaction

Get a Transaction Minimum Configuration Sample


curl 'https://mock.blazemeter.com/api/v1/workspaces/123456/transactions/77' \
    -X GET \
    -H 'accept: */*'

The following parameters are the base parameters required to get a Transaction.

Get a Transaction Request Attributes

Response 200 OK

{
  "apiVersion": 0,
  "error": "string",
  "limit": 0,
  "link": "string",
  "requestId": "string",
  "result": {
    "description": "string",
    "dsl": {
          "priority": 1,
          "requestDsl": {
            "method": "GET",
            "host": "http://miurl.com.ec",
            "path": "",
            "url": {
              "key": "url",
              "matcherName": "equals_url",
              "matchingValue": "miurl.com.ec"
            },
            "headers": [],
            "queryParams": [],
            "cookies": [],
            "credentials": {},
            "body": []
          },
          "responseDsl": {
            "status": 200,
            "statusMessage": "OK",
            "proxyUrl": "",
            "headers": [],
            "binary": false,
            "contentType": "json",
            "content": "",
            "charset": "UTF-8"
          }
        } ,
    "id": 0,
    "link": "string",
    "name": "string",
    "serviceId": 0,
    "serviceName": "string",
    "tags": [
      "string"
    ]
  },
  "skip": 0,
  "total": 0
}

Attributes

transactionId integer
required

The transaction identifier
workspaceId integer
required

The Workspace identifier
type string

The Transaction type (dsl) to filter by

Get All Transactions

To get all Transactions within a Service, you need to know your Workspace identifier and the Service identifier. The sample code uses a serviceId of 123 and a workspaceId of 123456. Use the actual ID values of your Workspace and Service.

You can filter Transactions by a (sub)string, Transaction name, Mock Service identifier, workspaceId, custom Tags, or Transaction type (dsl).

Minimum Parameters for getting all Transactions

Get All Transactions Minimum Configuration Sample


curl 'https://mock.blazemeter.com/api/v1/workspaces/123456/transactions?serviceId=123' \
    -X GET \
    -H 'accept: */*'

The following parameters are the base parameters required to get all Transactions.

Get All Transactions Request Attributes

Response 200 OK

{
  "apiVersion": 0,
  "error": "string",
  "limit": 0,
  "link": "string",
  "requestId": "string",
  "result": [
    {
      "description": "string",
      "dsl": {
          "priority": 1,
          "requestDsl": {
            "method": "GET",
            "host": "http://miurl.com.ec",
            "path": "",
            "url": {
              "key": "url",
              "matcherName": "equals_url",
              "matchingValue": "miurl.com.ec"
            },
            "headers": [],
            "queryParams": [],
            "cookies": [],
            "credentials": {},
            "body": []
          },
          "responseDsl": {
            "status": 200,
            "statusMessage": "OK",
            "proxyUrl": "",
            "headers": [],
            "binary": false,
            "contentType": "json",
            "content": "",
            "charset": "UTF-8"
          }
        } ,
      "id": 0,
      "link": "string",
      "name": "string",
      "serviceId": 123,
      "serviceName": "string",
      "tags": [
        "string"
      ]
    }
  ],
  "skip": 0,
  "total": 0
}

Attributes

serviceMockId integer

The identifier of the Service Mock whose Transaction you want to get
serviceId integer
required

The identifier of the Service whose Transaction you want to get
workspaceId integer
required

The Workspace identifier
filter string

Text by which you want to filter the query result
limit integer

Number of results per page
query string

Name of the Transaction to get
skip integer

Number of initial results to skip
sort string

The column name by which you want to sort the result: id, name, or description
tags string

Tags by which you want to filter the result
type string

Transaction type (dsl) by which you want to filter the result

Perform Bulk Operation Over Transactions

To perform a bulk delete or tag operation over several Transactions in a Workspace, you need to know your Workspace identifier. The sample code uses a workspaceId of 123456. Use the actual ID value of your Workspace.

Minimum Parameters for bulk operations

Bulk Operations Minimum Configuration Sample


curl 'https://mock.blazemeter.com/api/v1/workspaces/123456/transactions' \
  -X PATCH \
  -H 'accept: */*' \
  -H 'Content-Type: application/json' \
  -d '{ "action": "DELETE", "tags": [ "some_category" ], "transactions": [ 0 ]}'

The following parameters are the base parameters required to perform bulk operations.

Bulk Operations Request Attributes

Response 200 OK

{
  "body": {},
  "statusCode": "100 CONTINUE",
  "statusCodeValue": 0
}

Attributes

workspaceId integer
required

The Workspace identifier
action string

The bulk action. Possible values: DELETE, TAG
tag string

The tag to apply to the listed Transactions. Used together with the TAG action
transactions array

List of Transactions

Update Transaction

To update an existing Transaction in your Workspace, you need to know your Workspace identifier and the Transaction identifier. The sample code uses a transactionId of 77 and a workspaceId of 123456. Use the actual ID values of your workspace and Transaction.

Minimum Parameters for Updating a Transaction

The following parameters are the base parameters required to update a Transaction.

Update a Transaction Request Attributes

Update a Transaction Minimum Configuration Sample


curl 'https://mock.blazemeter.com/api/v1/workspaces/123456/transactions/77' \
   -X PUT \
   -H 'accept: */*' \
   -H 'Content-Type: application/json' \
   -d '{ "description": "string",
         "dsl": { \
                "priority": 1, \
                "requestDsl": { \
                  "method": "GET", \
                  "host": "http://miurl.com.ec", \
                  "path": "", \
                  "url": { \
                    "key": "url", \
                    "matcherName": "equals_url", \
                    "matchingValue": "miurl.com.ec" \
                  }, \
                  "headers": [], \
                  "queryParams": [], \
                  "cookies": [], \
                  "credentials": {}, \
                  "body": [] \
                }, \
                "responseDsl": { \
                  "status": 200, \
                  "statusMessage": "OK", \
                  "proxyUrl": "", \
                  "headers": [], \
                  "binary": false, \
                  "contentType": "json", \
                  "content": "", \
                  "charset": "UTF-8" \
                } \
              } \
         "id": 0, \
         "link": "string", \
         "name": "string", \
         "serviceId": 0, \
         "serviceName": "string", \
         "tags": [ "string" ]
       }'

Response 201 Created

{
  "apiVersion": 0,
  "error": "string",
  "limit": 0,
  "link": "string",
  "requestId": "string",
  "result": {
    "created": "2019-07-24T16:07:03.541Z",
    "createdBy": "string",
    "createdDate": "string",
    "description": "string",
    "endpointPreference": "string",
    "harborId": "string",
    "httpEndpoint": "string",
    "httpsEndpoint": "string",
    "id": 0,
    "liveSystemHost": "string",
    "liveSystemPort": 0,
    "name": "string",
    "noMatchingRequestPreference": "string",
    "noMatchingRequestTxnId": 0,
    "serviceId": 0,
    "serviceName": "string",
    "shipId": "string",
    "status": "STOPPED",
    "thinkTime": 0,
    "mockServiceTransactions": [
      0
    ],
    "updated": "2019-07-24T16:07:03.541Z",
    "updatedBy": "string"
  },
  "skip": 0,
  "total": 0
}

Attributes

workspaceId integer
required

The Workspace identifier
transactionId integer
required

The transaction identifier

Delete Transaction

To delete a Transaction, you need to know the Transaction identifier and your Workspace identifier. The sample code uses a transactionId of 888 and a workspaceId of 123456. Use the actual ID value of your Transaction.

Minimum Parameters for Deleting a Transaction

Delete a Transaction Minimum Configuration Sample

curl 'https://mock.blazemeter.com/api/v1/workspaces/123456/transactions/77' \
    -X DELETE \
    -H 'accept: */*'

The following parameters are the base parameters required to delete a Transaction.

Delete a Transaction Request Attributes

Response 200 OK

{
  "body": {},
  "statusCode": "100 CONTINUE",
  "statusCodeValue": 0
}

Attributes

workspaceId integer
required

The Workspace identifier
transactionId integer
required

The Transaction identifier

Get All Conflicting Transactions

To get all conflicting Transactions from a Service, you need to know your Workspace identifier. The sample code uses a workspaceId of 123456. Use the actual ID values of your Workspace and Service.

Minimum Parameters for getting all conflicting Transactions

Get All Conflicting Transactions Minimum Configuration Sample


curl 'https://mock.blazemeter.com//api/v1/workspaces/123456/transactions/conflicts' \
    -X GET \
    -H 'accept: */*'

The following parameters are the base parameters required to get all conflicting Transactions.

Get All Conflicting Transactions Request Attributes

Response 200 OK

{
  "apiVersion": 0,
  "error": "string",
  "limit": 0,
  "link": "string",
  "requestId": "string",
  "result": {
    "additionalProp1": [
      {
        "description": "string",
        "dsl": {
          "priority": 1,
          "requestDsl": {
            "method": "GET",
            "host": "http://miurl.com.ec",
            "path": "",
            "url": {
              "key": "url",
              "matcherName": "equals_url",
              "matchingValue": "miurl.com.ec"
            },
            "headers": [],
            "queryParams": [],
            "cookies": [],
            "credentials": {},
            "body": []
          },
          "responseDsl": {
            "status": 200,
            "statusMessage": "OK",
            "proxyUrl": "",
            "headers": [],
            "binary": false,
            "contentType": "json",
            "content": "",
            "charset": "UTF-8"
          }
        } ,
        "id": 0,
        "link": "string",
        "name": "string",
        "serviceId": 0,
        "serviceName": "string",
        "tags": [
          "string"
        ]
      }
    ],
    "additionalProp2": [
      {
        "description": "string",
        "dsl": {
          "array": true,
          "bigDecimal": true,
          "bigInteger": true,
          "binary": true,
          "boolean": true,
          "containerNode": true,
          "double": true,
          "float": true,
          "floatingPointNumber": true,
          "int": true,
          "integralNumber": true,
          "long": true,
          "missingNode": true,
          "nodeType": "ARRAY",
          "null": true,
          "number": true,
          "object": true,
          "pojo": true,
          "short": true,
          "textual": true,
          "valueNode": true
        },
        "id": 0,
        "link": "string",
        "name": "string",
        "serviceId": 0,
        "serviceName": "string",
        "tags": [
          "string"
        ]
      }
    ],
    "additionalProp3": [
      {
        "description": "string",
        "dsl": {
          "array": true,
          "bigDecimal": true,
          "bigInteger": true,
          "binary": true,
          "boolean": true,
          "containerNode": true,
          "double": true,
          "float": true,
          "floatingPointNumber": true,
          "int": true,
          "integralNumber": true,
          "long": true,
          "missingNode": true,
          "nodeType": "ARRAY",
          "null": true,
          "number": true,
          "object": true,
          "pojo": true,
          "short": true,
          "textual": true,
          "valueNode": true
        },
        "id": 0,
        "link": "string",
        "name": "string",
        "serviceId": 123,
        "serviceName": "string",
        "tags": [
          "string"
        ]
      }
    ]
  },
  "skip": 0,
  "total": 0
}

Attributes

serviceId string

The Service identifier
workspaceId integer
required

The Workspace identifier
limit integer

Number of results per page
skip string

Number of initial results to skip

Mock Service REST API

You can create a Mock Service that stands in for a live service for testing purposes.

Create Mock Services

To create a Mock Service in your workspace, you need to know your Workspace identifier. The sample code uses a workspaceId of 123456. Use the actual ID value of your Workspace.

The response contains a Mock Service identifier that you should note down. You will need this serviceMockID when you want to configure, deploy, or delete this Mock Service later.

Minimum Parameters for creating a Mock Service

Create a Mock Service Minimum Configuration Sample


curl 'https://mock.blazemeter.com/api/v1/workspaces/123456/service-mocks' \
  -X POST \
  -H 'accept: application/json;charset=UTF-8' \
  -H 'Content-Type: application/json' \
  -d '{ "description": "string", "endpointPreference": "string", "harborId": "string", "id": 0, "type": "TRANSACTIONAL", "liveSystemHost": "string", "liveSystemPort": 0, "name": "string", "noMatchingRequestPreference": "string", "noMatchingRequestTxnId": 0, "serviceId": 123, "shipId": "string", "thinkTime": 0, "mockServiceTransactions": [ {"txnId":1, "priority":9} ]}'

The following parameters are the base parameters required to create a Mock Service.

Create a Mock Service Request Attributes

Response 201 Created

{
  "apiVersion": 0,
  "error": "string",
  "errors": [
    {
      "code": "string",
      "message": "string",
      "severity": "WARN"
    }
  ],
  "limit": 0,
  "link": "string",
  "requestId": "string",
  "result": {
    "created": "2020-06-17T13:04:42.949Z",
    "createdBy": "string",
    "createdDate": "string",
    "description": "string",
    "endpointPreference": "string",
    "harborId": "string",
    "httpEndpoint": "string",
    "httpsEndpoint": "string",
    "id": 0,
    "isNew": true,
    "liveSystemHost": "string",
    "liveSystemPort": 0,
    "mockServiceTransactions": [
      {
        "priority": 0,
        "txnId": 0
      }
    ],
    "name": "string",
    "noMatchingRequestPreference": "string",
    "noMatchingRequestTxnId": 0,
    "replicas": 0,
    "serviceId": 0,
    "serviceName": "string",
    "shipId": "string",
    "status": "STOPPED",
    "thinkTime": 0,
    "type": "TRANSACTIONAL",
    "updated": "2020-06-17T13:04:42.949Z",
    "updatedBy": "string",
    "updatedDate": "string"
  },
  "skip": 0,
  "total": 0
}

Attributes

description string

The description of the new Mock Service.
endpointPreference string

Choose HTTP or HTTPS.
type string

Set the type to "TRANSACTIONAL" for transactional Mock Services. "SV" for DevTest MAR Mock Services is deprecated.
harborId string

(EOL) This identifier was used in MAR-based Mock Services only.
liveSystemHost string

The host of the live system.
liveSystemPort integer

The port of the live system.
name string

The name of the new Mock Service.
noMatchingRequestPreference string

What to do if there are no matching requests. Choose either return404 to return "no match found", or choose bypasslive to redirect to the live system.
noMatchingRequestTxnId integer

If there are no matching requests, this is the Transaction ID that did not match.
serviceId integer

The identifier of an existing Service that contains this Mock Service.
shipId string

(EOL) This identifier was used in MAR-based Mock Services only.
thinkTime integer

Think time is a synthetic delay inserted between test steps to ensure the test script moves at a human pace.
mockServiceTransactions array

The Transaction identifiers that are assigned to this Mock Service, as a list of {"txnId":1,"priority":9} entries. The field `txnId` is the identifier of an existing transaction that belongs to this service mock. The field `priority` is an integer value from 1 to 10 inclusive, where a lower number represents the desire to match the request first. You can leave the list empty and assign Transactions later.

Get All Mock Services

To get all Mock Services, you need to know your Workspace identifier and the Service identifier. The sample code uses a serviceId of 123 and a workspaceId of 123456. Use the actual ID values of your Workspace and Service.

You can filter by workspaceId and serviceId.

Minimum Parameters for getting all Mock Services

Get All Mock Services Minimum Configuration Sample


curl 'https://mock.blazemeter.com/api/v1/workspaces/26208/service-mocks?serviceId=123' \
    -X GET \
    -H 'accept: application/json;charset=UTF-8' \
    -H 'authorization: Basic Aa1Bb2Cc3Dd4Ee5Ff6Gg7Hh8Ii9Jj0Aa1Bb2Cc3Dd4Ee5Ff6'

The following parameters are the base parameters required to get all Mock Services.

Get All Mock Services Request Attributes

Response 200 OK

{
  "apiVersion": 1,
  "error": null,
  "result": [
    {
      "id": 1619,
      "name": "Some Service",
      "description": null,
      "created": 1563893805,
      "updated": 1563893805,
      "createdBy": "someone@example.com",
      "updatedBy": "someone@example.com"
    },
    {
      "id": 1618,
      "name": "Some other Service",
      "description": "A service that serves as an example",
      "created": 1563893804,
      "updated": 1563893804,
      "createdBy": "someone@example.com",
      "updatedBy": "someone@example.com"
    }
  ],
  "requestId": null,
  "limit": 5,
  "skip": 0,
  "total": 2
}

Attributes

limit integer

Number of results per page
name string

The Service name to filter by
skip integer

Number of initial results to skip
sort string

The column name to sort by: id, name, or description
workspaceId integer
required

The Workspace identifier

Get Mock Service

To get a Mock Service, you need to know your Workspace identifier and the Mock Service identifier. The sample code uses a serviceMockId of 1234 and a workspaceId of 123456. Use the actual ID values of your Workspace and Mock Service.

Minimum Parameters for Getting a Mock Service

Get Mock Service Minimum Configuration Sample

curl 'https://mock.blazemeter.com/api/v1/workspaces/123456/service-mocks/1234' \
    -X GET \
    -H 'accept: application/json;charset=UTF-8'

The following parameters are the base parameters required to get a Mock Service.

Get Mock Service Request Attributes

Response 200 OK

{
  "apiVersion": 0,
  "error": "string",
  "limit": 0,
  "link": "string",
  "requestId": "string",
  "result": {
    "created": "2019-07-24T16:06:01.427Z",
    "createdBy": "string",
    "createdDate": "string",
    "description": "string",
    "endpointPreference": "string",
    "harborId": "string",
    "httpEndpoint": "string",
    "httpsEndpoint": "string",
    "id": 0,
    "liveSystemHost": "string",
    "liveSystemPort": 0,
    "name": "string",
    "noMatchingRequestPreference": "string",
    "noMatchingRequestTxnId": 0,
    "serviceId": 0,
    "serviceName": "string",
    "shipId": "string",
    "status": "STOPPED",
    "thinkTime": 0,
    "mockServiceTransactions": [
      0
    ],
    "updated": "2019-07-24T16:06:01.427Z",
    "updatedBy": "string"
  },
  "skip": 0,
  "total": 0
}

Attributes

serviceMockId integer
required

The Mock Service identifier
workspaceId integer
required

The Workspace identifier

Update a Mock Service

To update an existing Mock Service in your Workspace, you need to know your Workspace identifier and the Mock Service identifier. The sample code uses a serviceMockId of 1234 and a workspaceId of 123456. Use the actual ID values of your Workspace and Mock Service.

Minimum Parameters for Updating a Mock Service

Update a Mock Service Minimum Configuration Sample


curl 'https://mock.blazemeter.com/api/v1/workspaces/123456/service-mocks/1234' \
    -X PUT \
    -H 'accept: application/json;charset=UTF-8' \
    -H 'Content-Type: application/json' \
    -d '{ "description": "string", \
          "endpointPreference": "string", \
          "harborId": "string", \
          "id": 0, \
          "liveSystemHost": "string", \
          "liveSystemPort": 0, \
          "name": "string", \
          "noMatchingRequestPreference": "string", \
          "noMatchingRequestTxnId": 0, \
          "serviceId": 0, \
          "shipId": "string", \
          "thinkTime": 0, \
          "mockServiceTransactions": [ 0 ]}'

The following parameters are the base parameters required to update a Mock Service.

Update a Mock Service Request Attributes

Response 201 Created

{
  "apiVersion": 0,
  "error": "string",
  "limit": 0,
  "link": "string",
  "requestId": "string",
  "result": {
    "created": "2019-07-24T16:07:03.541Z",
    "createdBy": "string",
    "createdDate": "string",
    "description": "string",
    "endpointPreference": "string",
    "harborId": "string",
    "httpEndpoint": "string",
    "httpsEndpoint": "string",
    "id": 0,
    "liveSystemHost": "string",
    "liveSystemPort": 0,
    "name": "string",
    "noMatchingRequestPreference": "string",
    "noMatchingRequestTxnId": 0,
    "serviceId": 0,
    "serviceName": "string",
    "shipId": "string",
    "status": "STOPPED",
    "thinkTime": 0,
    "mockServiceTransactions": [
      0
    ],
    "updated": "2019-07-24T16:07:03.541Z",
    "updatedBy": "string"
  },
  "skip": 0,
  "total": 0
}

Attributes

description string

The description of the Mock Service
endpointPreference string

Choose HTTP or HTTPS
harborId string

(EOL) This identifier was used in MAR-based Mock Services only.
id integer

The identifier of the Mock Service
liveSystemHost string

The host of the live system
liveSystemPort integer

The port of the live system
name string

The name of the new Mock Service
noMatchingRequestPreference string

What to do if there are no matching requests. Choose either return404 to return "no match found", or choose bypasslive to redirect to the live system
noMatchingRequestTxnId integer

If there are no matching requests, this is the Transaction ID that did not match
serviceId integer

The identifier of an existing Service that contains this Mock Service
shipId string

(EOL) This identifier was used in MAR-based Mock Services only.
thinkTime integer

Think time is a synthetic delay inserted between test steps to ensure the test script moves at a human pace
mockServiceTransactions array

The Transaction identifiers that are assigned to this Mock Service. You can leave the list empty and assign Transactions later
updated string

The time when this template was updated
updatedBy string

Name of the last user who updated the template

Apply Template to Mock Service

To apply an existing template to a Mock Service, you need to know your Workspace identifier and the Mock Service Template identifier. The sample code uses a serviceMockId of 1234, a serviceMockTemplateId of 8, and a workspaceId of 123456. Use the actual ID values of your Workspace and Mock Service template.

Minimum Parameters for applying a Mock Service template

Apply Mock Service Templates Minimum Configuration Sample


curl 'https://mock.blazemeter.com/api/v1/workspaces/123456/service-mocks/1234/apply-template/8' \
    -X PATCH \
    -H "accept: application/json" \

The following parameters are the base parameters required to update Mock Service templates.

Apply Mock Service Template Request Attributes

Response 200 OK

{
  "apiVersion": 0,
  "error": "string",
  "errors": [
    {
      "code": "string",
      "message": "string",
      "severity": "ERROR"
    }
  ],
  "limit": 0,
  "link": "string",
  "requestId": "string",
  "result": {
    "created": "2021-10-08T08:46:49.163Z",
    "createdBy": "string",
    "data": {
      "dataType": "CONFIGURATION"
    },
    "ended": "2021-10-08T08:46:49.163Z",
    "errors": [
      "string"
    ],
    "status": "FINISHED",
    "trackingId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "trackingUrl": "string",
    "updated": "2021-10-08T08:46:49.163Z",
    "updatedBy": "string",
    "warnings": [
      "string"
    ]
  },
  "skip": 0,
  "total": 0
}

Attributes

workspaceId integer
required

The identifier of the Workspace
serviceMockId integer
required

The identifier of the Mock Service
templateId integer
required

The identifier of the template

Delete Mock Services

To delete a Mock Service, you need to know your Workspace identifier and the Mock Service identifier. The sample code uses a serviceMockId of 1234 and a workspaceId of 123456. Use the actual ID values of your Workspace and Mock Service.

Minimum Parameters for Deleting a Mock Service

Delete Mock Service Minimum Configuration Sample

curl 'https://mock.blazemeter.com/api/v1/workspaces/123456/service-mocks/1234' \
    -X DELETE \
    -H 'accept: application/json;charset=UTF-8'

The following parameters are the base parameters required to delete a Mock Service.

Delete Mock Service Request Attributes

Response 200 OK

{
  "body": {},
  "statusCode": "100 CONTINUE",
  "statusCodeValue": 0
}

Attributes

serviceMockId integer
required

The Mock Service identifier
workspaceId integer
required

The Workspace identifier

Update Mock Service Properties

To update properties of an existing Mock Service in your Workspace, you need to know your Workspace identifier and the Mock Service identifier. The sample code uses a serviceMockId of 1234 and a workspaceId of 123456. Use the actual ID values of your Workspace and Mock Service.

Minimum Parameters for Updating Mock Service Properties

Update a Service Minimum Configuration Sample


curl 'https://mock.blazemeter.com/api/v1/workspaces/123456/service-mocks/1234' \
    -X PATCH \
    -H 'accept: application/json;charset=UTF-8' \
    -H 'Content-Type: application/json' \
    -d '{ "description": "string", \
          "endpointPreference": "string", \
          "harborId": "string", \
          "name": "string", \
          "serviceId": 0, \
          "shipId": "string", \
          "status": "STOPPED", \
          "mockServiceTransactions": [ 0 ]\
        }'

The following parameters are the base parameters required to update Mock Service properties.

Update Mock Service Properties Request Attributes

Response 201 Created

{
  "apiVersion": 0,
  "error": "string",
  "limit": 0,
  "link": "string",
  "requestId": "string",
  "result": {
    "created": "2019-07-24T16:21:44.603Z",
    "createdBy": "string",
    "createdDate": "string",
    "description": "string",
    "endpointPreference": "string",
    "harborId": "string",
    "httpEndpoint": "string",
    "httpsEndpoint": "string",
    "id": 0,
    "liveSystemHost": "string",
    "liveSystemPort": 0,
    "name": "string",
    "noMatchingRequestPreference": "string",
    "noMatchingRequestTxnId": 0,
    "serviceId": 0,
    "serviceName": "string",
    "shipId": "string",
    "status": "STOPPED",
    "thinkTime": 0,
    "mockServiceTransactions": [
      0
    ],
    "updated": "2019-07-24T16:21:44.603Z",
    "updatedBy": "string"
  },
  "skip": 0,
  "total": 0
}

Attributes

serviceMockId integer
required

The Mock Service identifier
workspaceId integer
required

The Workspace identifier
description string

The description of the Mock Service
endpointPreference string
required

Choose HTTP or HTTPS
harborId string

(EOL) This identifier was used in MAR-based Mock Services only.
serviceId integer

The identifier of the Service
shipId string

(EOL) This identifier was used in MAR-based Mock Services only.
name string

The name of the Mock Service
status string

You can set the status of a Mock Service to one of the following: STOPPED, RUNNING, CONFIGURING, FAILED (Service Mock initialization failed)
mockServiceTransactions array

The list of identifiers of the new Transactions used in this Mock Service

Deploy Mock Services

Use this request to deploy a container based on the Mock Service if it has not already been deployed.

To deploy a Mock Service, you need to know your Workspace identifier and the Mock Service identifier. The sample code uses a serviceMockId of 1234 and a workspaceId of 123456. Use the actual ID values of your Workspace and Mock Service.

Minimum Parameters for Deploying a Mock Service

Deploy Mock Service Minimum Configuration Sample

curl 'https://mock.blazemeter.com/api/v1/workspaces/123456/service-mocks/1234/deploy' \
  -X GET \
  -H 'accept: application/json;charset=UTF-8'

The following parameters are the base parameters required to deploy a Mock Service.

Deploy Mock Service Request Attributes

Response 200 OK

{
  "apiVersion": 0,
  "error": "string",
  "limit": 0,
  "link": "string",
  "requestId": "string",
  "result": {
    "trackingId": "string",
    "trackingUrl": "string"
  },
  "skip": 0,
  "total": 0
}

Attributes

serviceMockId integer
required

The Mock Service identifier
workspaceId integer
required

The Workspace identifier

Change the Status of a Mock Service

To stop a Mock Service, you need to know your Workspace identifier and the Mock Service identifier. The sample code uses a serviceMockId of 1234 and a workspaceId of 123456. Use the actual ID values of your Workspace and Mock Service.

Minimum Parameters for Stopping a Mock Service

Stop Mock Service Minimum Configuration Sample

curl 'https://mock.blazemeter.com/api/v1/workspaces/123456/service-mocks/1234/stop' \
    -X GET \
    -H 'accept: application/json;charset=UTF-8'

The following parameters are the base parameters required to stop a Mock Service.

Stop Mock Service Request Attributes

Response 200 OK

{
  "apiVersion": 0,
  "error": "string",
  "limit": 0,
  "link": "string",
  "requestId": "string",
  "result": [],
  "skip": 0,
  "total": 0
}

Attributes

serviceMockId integer
required

The Mock Service identifier
workspaceId integer
required

The Workspace identifier

Configure and Deploy Mock Services

To configure or deploy Mock Services, you need to know your Workspace identifier. The sample code uses a workspaceId of 123456. Use the actual ID value of your Workspace.

Minimum Parameters for Configuring/Deploying Mocks

Configure/deploy Mocks Minimum Configuration Sample

curl 'https://mock.blazemeter.com/api/v1/workspaces/123456/service-mocks/configure' \
    -X POST \
    -H 'accept: application/json;charset=UTF-8' \
    -H 'Content-Type: application/json' \
    -d '{ "dependencies": \
            { "services": \
                [ { "service": "PayPal", \
                    "mock-service": "PPRunner", \
                    "transactions": \
                        [ "getAccounts", "getBalances", "createAccount" ] \
                  }, \
                  { "service": "WesternUnion", \
                    "mock-service": "WURunner", \
                    "transaction-filter": \
                        { "tags": \
                            [ "dev", "stage" ] \
                        } \
                  }, \
                  { "service": "Facebook", \
                    "mock-service": "FBRunner", \
                    "mock-service-template": "FBRunnerTemplate" \
                  } \
                ] \
            } \
        }'

The following parameters are the base parameters required to configure/deploy Mock Services.

Configure/Deploy Mocks Request Attributes

Response 200 OK

{
  "apiVersion": 0,
  "error": "string",
  "limit": 0,
  "link": "string",
  "requestId": "string",
  "result": {
    "trackingId": "string",
    "trackingUrl": "string"
  },
  "skip": 0,
  "total": 0
}

Attributes

workspaceId string
required

The Workspace identifier

Configure or Reconfigure Mock Services

To configure or reconfigure an existing Mock Service, you need to know your Workspace identifier and the Mock Service identifier. The sample code uses a serviceMockId of 1234 and a workspaceId of 123456. Use the actual ID values of your Workspace and Mock Service.

Minimum Parameters for Configuring a Mock Service

Configure Mock Service Minimum Configuration Sample

curl 'https://mock.blazemeter.com/api/v1/workspaces/123456/service-mocks/1234/configure' \
  -X GET \
  -H 'accept: application/json;charset=UTF-8'

The following parameters are the base parameters required to configure a Mock Service.

Configure Mock Service Request Attributes

Response 200 OK

{
  "apiVersion": 0,
  "error": "string",
  "limit": 0,
  "link": "string",
  "requestId": "string",
  "result": {
    "trackingId": "string",
    "trackingUrl": "string"
  },
  "skip": 0,
  "total": 0
}

Attributes

serviceMockId integer
required

The Mock Service identifier
workspaceId integer
required

The Workspace identifier

Verify Taurus Configuration Dependencies

To validate Taurus configuration dependencies, you need to know your Workspace identifier. The sample code uses a workspaceId of 123456. Use the actual ID value of your Workspace.

Minimum Parameters for Validation

Validate Mock Services Minimum Configuration Sample

curl 'https://mock.blazemeter.com/api/v1/workspaces/123456/service-mocks/validate' \
    -X POST \
    -H 'accept: application/json;charset=UTF-8' \
    -H 'Content-Type: application/json' \
    -d '{ "dependencies": \
            { "services": \
                [ { "service": "PayPal", \
                    "mock-service": "PPRunner", \
                    "transactions": \
                        [ "getAccounts", "getBalances", "createAccount" ] \
                  }, \
                  { "service": "WesternUnion", \
                    "mock-service": "WURunner", \
                    "transaction-filter": \
                        { "tags": \
                            [ "dev", "stage" ] \
                        } \
                  }, \
                  { "service": "Facebook", \
                    "mock-service": "FBRunner", \
                    "mock-service-template": "FBRunnerTemplate" \
                  } \
                ] \
            } \
        }'

The following parameters are the base parameters required to validate Mock Services.

Validate Mock Services Request Attributes

Response 200 OK

{
  "apiVersion": 0,
  "error": "string",
  "limit": 0,
  "link": "string",
  "requestId": "string",
  "result": {
    "dependencies": {
      "array": true,
      "bigDecimal": true,
      "bigInteger": true,
      "binary": true,
      "boolean": true,
      "containerNode": true,
      "double": true,
      "float": true,
      "floatingPointNumber": true,
      "int": true,
      "integralNumber": true,
      "long": true,
      "missingNode": true,
      "nodeType": "ARRAY",
      "null": true,
      "number": true,
      "object": true,
      "pojo": true,
      "short": true,
      "textual": true,
      "valueNode": true
    },
    "errors": [
      "string"
    ],
    "warnings": [
      "string"
    ]
  },
  "skip": 0,
  "total": 0
}

Attribute Description

workspaceId
string
The Workspace identifier.
required

Attribute	Description
`workspaceId` string	The Workspace identifier. required

Mock Service Template REST API

Create Mock Service Template

To create a Mock Service templates, you need to know your Workspace identifier and the Service identifier. The sample code uses a serviceId of 123 and a workspaceId of 123456. Use the actual ID values of your Workspace and Service.

The response contains a template identifier that you should note down. You will need the ID when you want to configure, deploy, or delete this template later.

Create Mock Service Templates Minimum Configuration Sample


curl 'https://mock.blazemeter.com/api/v1/workspaces/123456/service-mock-templates?serviceId=123' \
    -X POST \
    -H 'accept: */*' \
    -H 'Content-Type: application/json' \
    -d '{ "created": "2019-07-25T13:20:53.808Z",  \
          "createdBy": "string",  \
          "description": "string",  \
          "liveSystemHost": "string",  \
          "liveSystemPort": 0,  \
          "name": "string",  \
          "noMatchingRequestPreference": "string",  \
          "noMatchingRequestTxnId": 0,  \
          "thinkTime": 0,  \
          "mockServiceTransactions": [ 0 ],  \
          "updated": "2019-07-25T13:20:53.808Z",  \
          "updatedBy": "string" \
        }''

The following parameters are the base parameters required to create a Mock Service template.

Create Mock Service Template Request Attributes

Response 200 OK

{
  "apiVersion": 0,
  "error": "string",
  "limit": 0,
  "link": "string",
  "requestId": "string",
  "result": {
    "created": "2019-07-25T13:25:10.373Z",
    "createdBy": "string",
    "description": "string",
    "id": 0,
    "liveSystemHost": "string",
    "liveSystemPort": 0,
    "name": "string",
    "noMatchingRequestPreference": "string",
    "noMatchingRequestTxnId": 0,
    "serviceId": 0,
    "serviceName": "string",
    "thinkTime": 0,
    "mockServiceTransactions": [
      0
    ],
    "updated": "2019-07-25T13:25:10.373Z",
    "updatedBy": "string"
  },
  "skip": 0,
  "total": 0
}

Attributes

description string

The description of the Mock Service
endpointPreference string

Choose HTTP or HTTPS
harborId string

(EOL) This identifier was used in MAR-based Mock Services only.
id integer

The identifier of the Mock Service
liveSystemHost string

The host of the live system
liveSystemPort integer

The port of the live system
name string

The name of the new Mock Service
noMatchingRequestPreference string

What to do if there are no matching requests. Choose either return404 to return "no match found", or choose bypasslive to redirect to the live system
noMatchingRequestTxnId integer

If there are no matching requests, this is the Transaction ID that did not match
serviceId integer

The identifier of an existing Service that contains this Mock Service
shipId string

(EOL) This identifier was used in MAR-based Mock Services only.
thinkTime integer

Think time is a synthetic delay inserted between test steps to ensure the test script moves at a human pace
mockServiceTransactions array

The Transaction identifiers that are assigned to this Mock Service. You can leave the list empty and assign Transactions later
updated string

The time when this template was updated
updatedBy string

Name of the last user who updated the template

Get All Mock Service Templates

To get all Mock Service templates, you need to know your Workspace identifier and the Service identifier. The sample code uses a serviceId of 123 and a workspaceId of 123456. Use the actual ID values of your Workspace and Service.

You can filter templates by workspaceId.

Minimum Parameters for getting all Mock Service templates

Get All Mock Templates Minimum Configuration Sample


curl 'https://mock.blazemeter.com/api/v1/workspaces/123456/service-mock-templates?serviceId=123' \
    -X GET  \
    -H 'accept: */*'

The following parameters are the base parameters required to get all Mock Service templates.

Get All Mock Service Templates Request Attributes

Response 200 OK

{
  "apiVersion": 0,
  "error": "string",
  "limit": 0,
  "link": "string",
  "requestId": "string",
  "result": [
    {
      "created": "2019-07-25T13:25:10.347Z",
      "createdBy": "string",
      "description": "string",
      "id": 0,
      "liveSystemHost": "string",
      "liveSystemPort": 0,
      "name": "string",
      "noMatchingRequestPreference": "string",
      "noMatchingRequestTxnId": 0,
      "serviceId": 0,
      "serviceName": "string",
      "thinkTime": 0,
      "mockServiceTransactions": [
        0
      ],
      "updated": "2019-07-25T13:25:10.347Z",
      "updatedBy": "string"
    }
  ],
  "skip": 0,
  "total": 0
}

Attributes

serviceMockId integer
required

The Mock Service identifier
workspaceId integer
required

The Workspace identifier

Get Mock Service Template

To get a Mock Service template, you need to know your Workspace identifier and the Mock Service Template identifier. The sample code uses a serviceMockTemplateId of 8 and a workspaceId of 123456. Use the actual ID values of your Workspace and Mock Service template.

Minimum Parameters for getting a Mock Service template

Get a Mock Service Template Minimum Configuration Sample


curl 'https://mock.blazemeter.com/api/v1/workspaces/123456/service-mock-templates/8' \
    -X GET \
    -H 'accept: */*'

The following parameters are the base parameters required to get a Mock Service template.

Get a Mock Service Template Request Attributes

Response 200 OK

{
  "apiVersion": 0,
  "error": "string",
  "limit": 0,
  "link": "string",
  "requestId": "string",
  "result": {
    "created": "2019-07-25T13:36:44.158Z",
    "createdBy": "string",
    "description": "string",
    "id": 0,
    "liveSystemHost": "string",
    "liveSystemPort": 0,
    "name": "string",
    "noMatchingRequestPreference": "string",
    "noMatchingRequestTxnId": 0,
    "serviceId": 0,
    "serviceName": "string",
    "thinkTime": 0,
    "mockServiceTransactions": [
      0
    ],
    "updated": "2019-07-25T13:36:44.158Z",
    "updatedBy": "string"
  },
  "skip": 0,
  "total": 0
}

Attributes

serviceMockId integer
required

The Mock Service identifier
workspaceId integer
required

The Workspace identifier

Update Mock Service Template

To update a Mock Service template, you need to know your Workspace identifier and the Mock Service Template identifier. The sample code uses a serviceMockTemplateId of 8 and a workspaceId of 123456. Use the actual ID values of your Workspace and Mock Service template.

Minimum Parameters for updating a Mock Service template

Update Mock Service Templates Minimum Configuration Sample


curl 'https://mock.blazemeter.com/api/v1/workspaces/123456/service-mock-templates/8' \
    -X PUT \
    -H 'Content-Type: application/json' \
    -d '{ "created": "2019-07-25T13:41:28.547Z", \
          "createdBy": "string", \
          "description": "string", \
          "liveSystemHost": "string", \
          "liveSystemPort": 0, \
          "name": "string", \
          "noMatchingRequestPreference": "string", \
          "noMatchingRequestTxnId": 0, \
          "thinkTime": 0, \
          "mockServiceTransactions": [ 0 ], \
          "updated": "2019-07-25T13:41:28.547Z", \
          "updatedBy": "string" \
        }'

The following parameters are the base parameters required to update Mock Service templates.

Update Mock Service Template Request Attributes

Response 200 OK

{
  "apiVersion": 0,
  "error": "string",
  "limit": 0,
  "link": "string",
  "requestId": "string",
  "result": {
    "created": "2019-07-25T13:45:01.191Z",
    "createdBy": "string",
    "description": "string",
    "id": 0,
    "liveSystemHost": "string",
    "liveSystemPort": 0,
    "name": "string",
    "noMatchingRequestPreference": "string",
    "noMatchingRequestTxnId": 0,
    "serviceId": 0,
    "serviceName": "string",
    "thinkTime": 0,
    "mockServiceTransactions": [
      0
    ],
    "updated": "2019-07-25T13:45:01.191Z",
    "updatedBy": "string"
  },
  "skip": 0,
  "total": 0
}

Attributes

description string

The description of the Mock Service template
endpointPreference string

Choose HTTP or HTTPS
harborId string

(EOL) This identifier was used in MAR-based Mock Services only.
id integer

The identifier of the Mock Service template
liveSystemHost string

The host of the live system
liveSystemPort integer

The port of the live system
name string

The name of the Mock Service
noMatchingRequestPreference string

What to do if there are no matching requests. Choose either return404 to return "no match found", or choose bypasslive to redirect to the live system
noMatchingRequestTxnId string

If there are no matching requests, this is the Transaction ID that did not match
updatedBy integer

Name of the last user who updated the template
updated date

When this template was updated
thinkTime integer

Think time is a synthetic delay inserted between test steps to ensure the test script moves at a human pace
updated array

The new identifiers of the Transactions that you want to use in this Mock Service

Delete Mock Service Template

To delete a Mock Service template, you need to know your Workspace identifier and the Mock Service Template identifier. The sample code uses a serviceMockTemplateId of 8 and a workspaceId of 123456. Use the actual ID values of your Workspace and Mock Service template.

Minimum Parameters for deleting a Mock Service template

Delete a Mock Service Template Minimum Configuration Sample


curl 'https://mock.blazemeter.com/api/v1/workspaces/123456/service-mock-templates/8' \
    -X DELETE \
    -H 'accept: */*'

The following parameters are the base parameters required to delete a Mock Service template.

Delete a Mock Service Template Request Attributes

Response 200 OK

{
  "apiVersion": 0,
  "error": "string",
  "limit": 0,
  "link": "string",
  "requestId": "string",
  "skip": 0,
  "total": 0
}

Attributes

serviceMockId integer
required

The Mock Service identifier
workspaceId integer
required

The Workspace identifier

Update Mock Service Template Properties

To update the properties of a Mock Service template, you need to know your Workspace identifier and the Mock Service Template identifier. The sample code uses a serviceMockTemplateId of 8 and a workspaceId of 123456. Use the actual ID values of your Workspace and Mock Service template.

Minimum Parameters for updating a Mock Service template

Update Mock Service Templates Minimum Configuration Sample


curl 'https://mock.blazemeter.com/api/v1/workspaces/123456/service-mock-templates/8' \
    -X PATCH \
    -H 'accept: */*' \
    -H 'Content-Type: application/json' \
    -d '{ "description": "string", \
          "location": "string", \
          "name": "string",\
          "mockServiceTransactions": [ 0 ] \
        }'

The following parameters are the base parameters required to update Mock Service templates.

Update Mock Service Template Request Attributes

Response 200 OK

{
  "apiVersion": 0,
  "error": "string",
  "limit": 0,
  "link": "string",
  "requestId": "string",
  "result": {
    "created": "2019-07-25T13:51:48.016Z",
    "createdBy": "string",
    "description": "string",
    "id": 0,
    "liveSystemHost": "string",
    "liveSystemPort": 0,
    "name": "string",
    "noMatchingRequestPreference": "string",
    "noMatchingRequestTxnId": 0,
    "serviceId": 0,
    "serviceName": "string",
    "thinkTime": 0,
    "mockServiceTransactions": [
      0
    ],
    "updated": "2019-07-25T13:51:48.016Z",
    "updatedBy": "string"
  },
  "skip": 0,
  "total": 0
}

Attributes

description string

The description of the template
location string

The location of the Service, for example "cloud", "us-east-1", or "London"
name string

The name of the template
mockServiceTransactions array

The identifiers of the Transactions used in this Mock Service

Mock Service Location REST API

You can label Workspaces with a unique identifier for a cloud location or a private location, for example "cloud", "us-east-1", or "London".

Get Location of a Workspace

To get the location of your Workspace, you need to know your Workspace identifier. The sample code uses a workspaceId of 123456. Use the actual ID value of your Workspace.

This call returns the Location identifier of your workspace.

Minimum Parameters for Getting the Location of a Workspace

Get Location Minimum Configuration Sample

curl 'https://mock.blazemeter.com/api/v1/workspaces/123456/locations' \
    -X GET \
    -H 'accept: application/json;charset=UTF-8'

The following parameters are the base parameters required to get the location.

Get Location Request Attributes

Response 200 OK

{
    "apiVersion": 1,
    "error": null,
    "result": [
      {
        "shipId": "1234567890abcd1234567890",
        "shipName": "Test Agent",
        "harborId": "0987654321abcd0987654321",
        "harborName": "My Private Location",
        "provider": "Private Locations"
      }
    ],
    "requestId": "12345abcdef67890"
}

Attributes

workspaceId integer
required

The Workspace identifier

Mock Service Log REST API

Refresh the Logs of a Mock Service

Before you can get a log of a Mock Service in the asset catalog, you must refresh the log. You need to know your Workspace identifier and the Mock Service identifier. The sample code uses a serviceMockId of 1234 and a workspaceId of 123456. Use the actual ID values of your Workspace and Mock Service.

This call returns an async tracking object. After the tracking object reports that the logs of all instances (replicas) of a Mock Service have been refreshed, use the getter to get the most recent version of the log file of the mock service. The request returns the logId.

Minimum Parameters for Refreshing the Log of a Mock Service

Refresh Log of Mock Service Minimum Configuration Sample

curl 'https://mock.blazemeter.com/api/v1/workspaces/123456/service-mocks/1234/log/refresh' \
    -X POST \
    -H 'accept: */*' \
    -H 'Content-Type: application/json' \
    -d '0'

The following parameters are the base parameters required to refresh the Log of a Mock Service.

Mock Service Logs Request Attributes

Response 200 OK

{
  "apiVersion": 0,
  "error": "string",
  "limit": 0,
  "link": "string",
  "requestId": "string",
  "result": {
    "log": "string",
    "logId": 0,
    "serviceMockId": 1234,
    "trackingId": "string"
  },
  "skip": 0,
  "total": 0
}

Attributes

serviceMockId integer
required

The Mock Service identifier
workspaceId integer
required

The Workspace identifier
limit integer

The Number of results per page

Get a Log File of a Mock Service

To get a log snapshot of all instances (replicas) of a Mock Service either as JSON or as GZIP file, you need to know the your Workspace identifier and the Mock Service identifier. The sample code uses a serviceMockId of 1234 and a workspaceId of 123456. Use the actual ID values of your Workspace and Mock Service.

In order to get the latest logs, always call https://mock.blazemeter.com//api/v1/workspaces/{workspaceId}/service-mocks/{serviceMockId}/log/refresh first.

Minimum Parameters for Requesting a Log File of a Mock Service

The following parameters are the base parameters required to request a log file of a Mock Service.

Log File of Mock Service Request Attributes

Request Log File of Mock Service Minimum Configuration Sample

curl 'https://mock.blazemeter.com//api/v1/workspaces/{workspaceId}/service-mocks/{serviceMockId}/log' \
    -X GET \
    -H 'accept: application/json;charset=UTF-8'

Response 200 OK

{}

Attributes

serviceMockId integer
required

The Mock Service identifier
workspaceId integer
required

The Workspace identifier

Take a Log Snapshot of a Mock Service

To request a log snapshot of a Mock Service, you need to know your Workspace identifier and the Mock Service identifier. The sample code uses a serviceMockId of 1234 and a workspaceId of 123456. Use the actual ID values of your Workspace and Mock Service.

The request returns the logId.

Minimum Parameters for Requesting a Log of a Mock Service

Request Log of Mock Service Minimum Configuration Sample

curl 'https://mock.blazemeter.com/api/v1/workspaces/123456/service-mocks/1234/log' \
    -X GET \
    -H 'accept: */*' \
    -H 'Content-Type: application/json' \
    -d '0'

The following parameters are the base parameters required to request a Log of a Mock Service.

Mock Service Logs Request Attributes

Response 200 OK

{
  "apiVersion": 0,
  "error": "string",
  "limit": 0,
  "link": "string",
  "requestId": "string",
  "result": {
    "log": "string",
    "logId": 0,
    "serviceMockId": 1234,
    "trackingId": "string"
  },
  "skip": 0,
  "total": 0
}

Attribute Description

serviceMockId
string
The Mock Service identifier.
required

workspaceId
string
The Workspace identifier.
required

limit
string
The Number of results per page.

Attribute	Description
`serviceMockId` string	The Mock Service identifier. required
`workspaceId` string	The Workspace identifier. required
`limit` string	The Number of results per page.

Update the Log Snapshot of a Mock Service

To update a log snapshot of a Mock Service and save it to the asset catalog, you need to know the Log Identifier, Workspace identifier and the Mock Service identifier. The sample code uses a logID of 42, a serviceMockId of 1234 and a workspaceId of 123456. Use the actual ID values of your Log, Workspace, and Mock Service.

To get the logID, take a log snapshot of the Mock Service.

Minimum Parameters for Updating the Log of a Mock Service

Update Log of Mock Service Minimum Configuration Sample

curl 'https://mock.blazemeter.com/api/v1/workspaces/123456/service-mocks/1234/log/42' \
    -X PUT \
    -H 'accept: */*' \
    -H 'Content-Type: application/json' \
    -d 'string'

The following parameters are the base parameters required to update the log of a Mock Service.

Update Log of Mock Service Request Attributes

Response 200 OK

{
  "apiVersion": 0,
  "error": "string",
  "limit": 0,
  "link": "string",
  "requestId": "string",
  "result": true,
  "skip": 0,
  "total": 0
}

Attributes

serviceMockId integer
required

The Mock Service identifier
workspaceId integer
required

The Workspace identifier
logId integer
required

The Log identifier
log string
required

The updated Log values

Get the Request ID of a Mock Service (Analytics)

To retrieve log information for any Mock Service through our Analytics endpoint, you need the Request ID of the Mock Service. To get the Request ID, you need the Workspace identifier and the Mock Service identifier. The sample code uses a serviceMockId of 1234 and a workspaceId of 123456. Use the actual ID values of your Log, Workspace, and Mock Service. The response contains the requestId in the result id: {“result” : [ { “id” : 7777, ...} ] }.

Minimum Parameters for Getting the Request ID of a Mock Service

The following parameters are the base parameters required for getting the Request ID of a Mock Service.

Get the Request ID of a Mock Service Request Attributes

Get the Request ID of a Mock Service Minimum Configuration Sample

curl 'https://analytics.blazemeter.com/reports/api/v1/workspaces/123456/inspection-data/service-mock/1234' \
    -X GET \
    -H 'accept: application/json;charset=UTF-8'

Response 200 OK

{
  “apiVersion” : 1,
  “error” : null,
  “result” : [ {
    “id” : 7777,
    “serviceMockId” : 114193,
    “type” : “TRANSACTIONAL”,
    “transactionId” : null,
    “operation” : “GET”,
    “url” : “http://test131142.mock.blazemeter.com/favicon.ico”,
    “timestamp” : 1681213707061,
    “arguments” : [ ],
    “matchType” : null,
    “matchTolerance” : null,
    “hasError” : false,
    “respondingTxn” : null,
    “matched” : false,
    “txnPriority” : null,
    “source” : “MOCK”,
    “liveTransactionCreated” : false,
    “hash” : null,
    “detailsHash” : null,
    “webHookName” : null,
    “webHookId” : null,
    “modelEntity” : null,
    “actionName” : null,
    “objectAction” : null
  }, {
    “id” : 1156936109,
    “serviceMockId” : 114193,
    “type” : “TRANSACTIONAL”,
    “transactionId” : 5763762,
    “operation” : “GET”,
    “url” : “http://test131142.mock.blazemeter.com/test”,
    “timestamp” : 1681213706737,
    “arguments” : [ ],
    “matchType” : null,
    “matchTolerance” : null,
    “hasError” : false,
    “respondingTxn” : null,
    “matched” : true,
    “txnPriority” : 10,
    “source” : “MOCK”,
    “liveTransactionCreated” : false,
    “hash” : null,
    “detailsHash” : null,
    “webHookName” : null,
    “webHookId” : null,
    “modelEntity” : null,
    “actionName” : null,
    “objectAction” : null
  } ],
  “requestId” : null
}

Attributes

serviceMockId integer
required

The Mock Service identifier
workspaceId integer
required

The Workspace identifier
requestId integer
required

The Mock Service Request identifier.

Request the Analytics of a Mock Service

You can retrieve inspection data for any Mock Service through our Analytics endpoint.

To get more in-depth inspection data about the request and the response, you need to know the Request ID, Workspace identifier and the Mock Service identifier. The sample code uses a requestId of 7777, a serviceMockId of 1234 and a workspaceId of 123456. Use the actual ID values of your Log, Workspace, and Mock Service.

Minimum Parameters for Getting the Analytics of a Mock Service

The following parameters are the base parameters required to request inspection data of a Mock Service.

Get the Analytics of a Mock Service Request Attributes

Get the Analytics of a Mock Service Minimum Configuration Sample

curl 'https://analytics.blazemeter.com/reports/api/v1/workspaces/123456/inspection-data/requests/7777' \
    -X GET \
    -H 'accept: application/json;charset=UTF-8'

Response 200 OK

{
  "apiVersion" : 1,
  "error" : null,
  "result" : {
    "serviceMockId" : 114193,
    "type" : "TRANSACTIONAL",
    "stepDetails" : null,
    "matchingData" : null,
    "sessionData" : null,
    "requestBody" : "",
    "requestHeaders" : [ {
      "key" : "Host",
      "value" : "test131142.mock.blazemeter.com"
    }, {
      "key" : "X-Request-ID",
      "value" : "f3b9c1320xxxx219e4e369186852516d"
    }, ..., {
      "key" : "Accept-Encoding",
      "value" : "gzip, deflate, br"
    }, {
      "key" : "Accept-Language",
      "value" : "en-GB,en-US;q=0.9,en;q=0.8,cs;q=0.7"
    } ],
    "responseBody" : "Tm8gbWF0Y2ggRm91bmQ=",
    "responseHeaders" : [ ],
    "statusCode" : 404,
    "hash" : null,
    "filters" : null,
    "parameters" : null,
    "changedRowsCount" : null
  },
  "requestId" : null
}

Attributes

serviceMockId integer
required

The Mock Service identifier
workspaceId integer
required

The Workspace identifier
requestId integer
required

The Mock Service Request identifier.

Appendix

This section contains additional details you may find useful as you progress in your use of the BlazeMeter Mock Service API beyond typical use cases.

Glossary

This section covers the various terms that are used throughout the Mock Service APIs.

DSL

The dsl is the object that stores properties of Transactions.

There are multiple sources we support and convert to DSL format to use them as request/response transactions:

Supported dsl type keys are:

SWAGGER2_DSL for Swagger Versions 2
SWAGGER3_DSL for Swagger Versions 3
CODESV_DSL for CodeSv
WIREMOCK_DSL for Wiremock
HAR_DSL for HTTP Archive format (HAR)
TAURUS_RECORDING for TaurusRecording format
RR_PAIR for R/R Pairs
GENERIC_DSL

For more information, see Adding Transactions.

This appendix shows how to configure a dsl manually. The easiest way to create a valid dsl for an API call is to create a Transaction in the web interface and copy and paste the response.

Example - Create a DSL object

Create a dsl object Minimum Configuration Sample

{
  "priority": 0,
  "requestDsl": {
    "method": "POST",    
    "url": {
      "key": "url",
      "matcherName": "equals_url",
      "matchingValue": "http://www.example.com"
    },
    "headers": [
      {
        "key": "header1",
        "matcherName": "contains",
        "matchingValue": "value1"
      },
      {
        "key": "header2",
        "matcherName": "matches",
        "matchingValue": "value2"
      },
      {
        "key": "header3",
        "matcherName": "equals",
        "matchingValue": "value3"
      },
      {
        "key": "header4",
        "matcherName": "not_matches",
        "matchingValue": "value4"
      },
      {
        "key": "header5",
        "matcherName": "equals_insensitive",
        "matchingValue": "value5"
      },
      {
        "key": "header6",
        "matcherName": "absent",
        "matchingValue": "header6"
      }
    ],
    "queryParams": [
      {
        "key": "q1",
        "matcherName": "contains",
        "matchingValue": "q_value1"
      },
      {
        "key": "q2",
        "matcherName": "matches",
        "matchingValue": "q_value2"
      },
      {
        "key": "q3",
        "matcherName": "equals",
        "matchingValue": "q_value3"
      },
      {
        "key": "q4",
        "matcherName": "not_matches",
        "matchingValue": "q_value4"
      },
      {
        "key": "q5",
        "matcherName": "equals_insensitive",
        "matchingValue": "q_value5"
      },
      {
        "key": "q6",
        "matcherName": "absent",
        "matchingValue": "q6"
      }
    ],
    "cookies": [
      {
        "key": "cookie1",
        "matcherName": "contains",
        "matchingValue": "c_value1"
      },
      {
        "key": "cookie2",
        "matcherName": "matches",
        "matchingValue": "c_value2"
      },
      {
        "key": "cookie3",
        "matcherName": "equals",
        "matchingValue": "c_value3"
      },
      {
        "key": "cookie4",
        "matcherName": "not_matches",
        "matchingValue": "c_value4"
      },
      {
        "key": "cookie5",
        "matcherName": "equals_insensitive",
        "matchingValue": "c_value5"
      },
      {
        "key": "cookie6",
        "matcherName": "absent",
        "matchingValue": "cookie6"
      }
    ],
    "credentials": {
      "username": "joe user",
      "password": "p455w0rd"
    },
    "body": [
      {
        "matcherName": "matches_json",
        "matchingValue": "JFsnbWVudSddWydpZCdd"
      }
    ]
  },
  "responseDsl": {
    "status": 200,
    "statusMessage": "HTTP/1.1 200 OK",
    "headers": [
      {
        "name": "Content-Type",
        "value": "text/plain; charset=UTF-8"
      }
    ],
    "binary": false,
    "content": "ZXhhbXBsZSBwb3N0IHJlc3BvbnNl",
    "charset": "UTF-8"
  }
}

To create a dsl manually, use the following format:

Attributes

requestDsl object

The request DSL details
- method string
  required
  
  HTTP verb used for the request
  
  Sample Values
  POST
  GET
  PUT
  PATCH
  DELETE
  OPTIONS
  TRACE
  HEAD
  CONNECT
  ANY
- url object
  
  URL or regular expression to match
  - key string
    
    Set this key to url to match URLs
    
    Sample Values
    url
  - matcherName string
    required
    
    Matcher operation to perform over given value
    
    Sample Values
    equals_url
    matches_url
    
    Note: For Wiremock and url type only, matcherName additionally supports any; in this case, no matchingValue is required
  - matchingValue string
    required
    
    Value to be matched.
    For type url, matchingValue is required and must be a valid URL for equals_url, or a valid regular expression for matches_url.
    For Wiremock with url type and matcherName any, matchingValue is not required
    
    Sample Values
    myurl.company.com
- headers array
  
  List of MatcherDsls that apply to header
  - key string
    required
    
    HTTP header name to match, value not encoded
    
    Sample Values
    header1
  - matcherName string
    required
    
    Matcher operation to perform over given value
    
    Sample Values
    contains
    matches
    equals
    equals_insensitive
    not_matches
    absent
  - matchingValue string
    required
    
    Value to be matched
    
    Sample Values
    value1
- queryParams array
  
  List of MatcherDsls that apply to query parameters
  - key string
    required
    
    Query line parameter name to match, value not encoded
    
    Sample Values
    queryParam1
  - matcherName string
    required
    
    Matcher operation to perform over given value
    
    Sample Values
    contains
    matches
    equals
    equals_insensitive
    not_matches
    absent
  - matchingValue string
    required
    
    Value to be matched
    
    Sample Values
    value1
- cookies array
  
  List of MatcherDsls that apply to cookies
  - key string
    required
    
    Request cookie name to match, value not encoded
    
    Sample Values
    cookie1
  - matcherName string
    required
    
    Matcher operation to perform over given value
    
    Sample Values
    contains
    matches
    equals
    equals_insensitive
    not_matches
    absent
  - matchingValue string
    required
    
    Value to be matched
    
    Sample Values
    value1
- credentials object
  
  Credentials to use for basic authentication
  - username string
    
    The username for your credential
    
    Sample Values
    joe user
  - password string
    
    The password for your credential
    
    Sample Values
    p455w0rd
- body array
  
  List of MatcherDsls that apply to body
  - matcherName string
    required
    
    Matcher operation to perform over given value
    
    Sample Values
    contains
    equals
    equals_insensitive
    equals_json
    matches_json
    equals_xml
    matches_xml
    equals_binary
    not_matches
    absent
  - matchingValue string
    required
    
    Value to be matched. Encode this value into base64
    
    Sample Values
    JFsnbWVudSddWydpZCdd
responseDsl object

The response DSL details
- status integer
  
  Status response code
  
  Sample Values
  1xx information
  2xx success
  3xx redirection
  4xx server errors
  5xx client errors
  See HTTP Status Codes
- statusMessage string
  
  Status response message
  
  Sample Values
  "HTTP/1.1 200 OK"
  See HTTP Status Codes
- proxyUrl string
  
  URL of proxy server, if required
  
  Sample Values
  https://proxy.corp.com
- headers array
  
  Response header elements
  
  Sample Values
  "headers": [ { "name": "Content-Type", "value": "text/plain; charset=UTF-8" }
  - name string
    
    The header name
    
    Sample Values
    Content-Type
  - value string
    
    The header value
    
    Sample Values
    text/plain; charset=UTF-8
- binary boolean
  
  Whether the response is in binary format
  
  Sample Values
  false
  true
- contentType boolean
  
  Content-type of the response body. See IANA.org
  
  Sample Values
  application/json
  text/plain
  text/xml, ...
- content string
  
  The response body content to return. Encode this value into base64
  
  Sample Values
  SGVsbG8gd29ybGQhCg==
- charset string
  
  The encoding used in response
  
  Sample Values
  UTF-8

Bridge ID

(EOL) This identifier was used in MAR-based Mock Services only.

Harbor ID

(EOL) This identifier was used in MAR-based Mock Services only.

Location ID

This is the unique identifier for a cloud location or a private location. It is used in the following APIs:

Mock Service Location
Update Properties of a Mock Service Template

It is found in the response of the following APIs:

Get Location of a Workspace
Get Mock Service Location
Get Mock Service User Details

For another method for finding this value, see Get the Location Name.

Log ID

This is the unique identifier of a log. It is used in the following APIs:

Get a Log file of a Mock Service
Update the Log Snapshot of a Mock Service

It is found in the response of the following APIs:

Take a Log Snapshot of a Mock Service
Refresh the Logs of a Mock Service

Mock Service ID

Configure or Reconfigure Mock Services
Delete Mock Services
Deploy Mock Services
Get a Log File of a Mock Service
Take a Log Snapshot of a Mock Service
Update the Log Snapshot of a Mock Service
Get Mock Service
Stop a Mock Service
Delete Mock Service Template
Update Mock Service Properties
Update a Mock Service

It is found in the response of the following APIs:

Create Mock Services

Mock Service Template ID

This is the unique identifier of a Template. It is used in the following APIs:

Delete Mock Service Template
Update Mock Service Template Properties
Update Mock Service Template
Apply Mock Service Template to Mock Service

It is found in the response of the following APIs:

Create Mock Service Template
Get All Mock Service Templates
Get Mock Service Template

Registry ID

(EOL) This identifier was used in MAR-based Mock Services only.

Request ID

This is the unique Mock Service Request identifier for a given Mock Service in a given Workspace.

It is found in the response of the following API call in the result id: {“result” : [ { “id” : 7777, ...} ] }:

Get the Request ID of a Mock Service (Analytics)

It is used in the following APIs:

Request the Analytics of a Mock Service

Service ID

This is the unique identifier of a Service. It is used in the following APIs:

Get Service by ID
Get All Mock Services
Update a Service
Create Mock Service Template
Get All Mock Service Templates
Create Transaction From Sources
Create Transaction
Get All Transactions

It is found in the response of the following APIs:

Create a Service
Get All Services
Update a Service
Get Transaction

Ship ID

(EOL) This identifier was used in MAR-based Mock Services only.

Tag ID

This is the unique identifier of a tag. It is used in the following APIs:

Delete Tag
Get Tag by ID
Update a Tag

It is found in the response of the following APIs:

Create a Tag
Get All Tags
Get Tag by Name

Taurus UUID

Get Tracking by UUID

Transaction ID

This is the unique identifier of a Transaction. It is used in the following APIs:

Delete Transaction
Get Transaction
Update Transaction

It is found in the response of the following APIs:

Create Transaction From Sources
Create Transaction
Get All Transactions
Get All Conflicting Transactions

Workspace ID

This is the unique identifier that identifies a Workspace. It is used in the following APIs:

Configure and Deploy Mock Services
Configure or Reconfigure Mock Services
Create Mock Services
Delete Mock Services
Deploy Mock Services
Get All Mock Services
Get Workspace Location
Get a Log File of a Mock Service
Take a Log Snapshot of a Mock Service
Update the Log Snapshot of a Mock Service
Get Mock Service
Create a Service
Get All Services
Get Service by ID
Update a Service
Stop a Mock Service
Create Mock Service Template
Get All Mock Service Templates
Get Mock Service Template
Update Mock Service Template Properties
Update Mock Service Template
Perform Bulk Operation Over Transactions
Create Transaction From Sources
Create Transaction
Delete Transaction
Get All Transactions
Get All Conflicting Transactions
Get Transaction
Update Transaction
Update Mock Service Properties
Update a Mock Service
Verify Taurus Configuration Dependencies

It is found in the response of the following APIs:

Get Details of Currently Logged-In User
Get Tracking by UUID

For another method for finding this value, see Get Your Workspace ID.

Introduction

Overview

Authorization Using Basic Authentication

Create the API Key

Mock Service Service REST API

Create a Service

Create a Service Request Attributes

Attributes

workspaceId stringrequired

description string

name string

Get All Services

Minimum Parameters for getting all Services

Get All Services Request Attributes

Attributes

limit integer

name string

skip integer

sort string

workspaceId integerrequired

Get Service by ID

Minimum Parameters for Getting a Service by its ID

Get a Service Request Attributes

Attributes

serviceId stringrequired

workspaceId integerrequired

Update a Service

Minimum Parameters for Updating a Service

Update a Service Request Attributes

Attributes

serviceId integerrequired

workspaceId integerrequired

description stringrequired

name stringrequired

Tag REST API

Create a Tag

Create a Tag Request Attributes

Attributes

description string

name string

Get All Tags

Minimum Parameters for getting all tags

Get All Tags Request Attributes

Attributes

limit integer

skip integer

sort string

Get Tag by ID

Minimum Parameters for Getting a Tag by ID

Get Tag by ID Request Attributes

Attributes

tagId integerrequired

Get Tag by Name

Minimum Parameters for Getting a Tag by Name

Get Tag by Name Request Attributes

Attributes

name stringrequired

Update a Tag

Minimum Parameters for Updating a Tag

Update a Tag Request Attributes

Attributes

description stringrequired

id integerrequired

name string

Delete Tag

Minimum Parameters for Deleting a Tag

Delete a Tag Request Attributes

Attributes

tagId integerrequired

Transaction API

Transaction Types (DSL)

Create Transaction

Create a Transaction Request Attributes

Attributes

workspaceId integerrequired

serviceId integerrequired

name stringrequired

description string

tags array

dsl objectrequired

`workspaceId` string
required

`description` string

`name` string

`limit` integer

`name` string

`skip` integer

`sort` string

`workspaceId` integer
required

`serviceId` string
required

`workspaceId` integer
required

`serviceId` integer
required

`workspaceId` integer
required

`description` string
required

`name` string
required

`description` string

`name` string

`limit` integer

`skip` integer

`sort` string

`tagId` integer
required

`name` string
required

`description` string
required

`id` integer
required

`name` string

`tagId` integer
required

`workspaceId` integer
required

`serviceId` integer
required

`name` string
required

`description` string

`tags` array

`dsl` object
required

`workspaceId` integer
required

`serviceId` integer
required

`verbose` boolean

`transactionId` integer
required

`workspaceId` integer
required

`type` string

`serviceMockId` integer

`serviceId` integer
required

`workspaceId` integer
required

`filter` string

`limit` integer

`query` string

`skip` integer

`sort` string

`tags` string

`type` string

`workspaceId` integer
required

`action` string

`tag` string

`transactions` array

`workspaceId` integer
required

`transactionId` integer
required

`workspaceId` integer
required

`transactionId` integer
required

`serviceId` string

`workspaceId` integer
required

`limit` integer

`skip` string

`description` string

`endpointPreference` string

`type` string

`harborId` string

`liveSystemHost` string