Apica Synthetic Monitoring Api
Documentation for the routes in Apica Synthetic Monitoring API.


Support: support@apicasystem.com
+1 (310) 776-7540
+46 (8) 400 273 27

Checks

Method Route Description
GET /checks?enabled={enabled}&severity={severity} Gets a list of checks that are visible to you as a user or a customer depending on the request context. The result can be filtered by optional parameters.
POST /checks Gets a list of checks that are visible to you as a user or a customer depending on the request context.
GET /checks/{checkId} Gets info about a check, current SLA, last result and its status.
PUT /checks/{checkId} Updates a check.
DELETE /checks/{checkId} Deletes a check.
POST /checks/url Creates a new URL check (legacy version 1).
POST /checks/url-v2 Creates a new URL check (version 2).
POST /checks/browser Creates a new browser check.
POST /checks/proxysniffer Creates a new ZebraTester check.
POST /checks/command Creates a new Command check.
POST /checks/command-v2 Creates a new Command check (version 2).
POST /checks/port Creates a new Port check.
POST /checks/ping Creates a new Ping check.
PUT /checks/command-v2/{checkId} Updates a command check (version 2).
PUT /checks/url/{checkId} Updates a URL check (legacy version 1).
PUT /checks/url-v2/{checkId} Updates a URL check (version 2).
PUT /checks/browser/{checkId} Updates a browser check.
PUT /checks/proxysniffer/{checkId} Updates a ZebraTester check.
PUT /checks/command/{checkId} Updates a command check.
PUT /checks/port/{checkId} Updates a Port check.
PUT /checks/ping/{checkId} Updates a Ping check.

ChecksLastValue

Method Route Description
GET /checks/{checkId}/lastvalue Gets the absolute last value of a specific check.

CommandCheckCategories

Method Route Description
GET /checks/command/categories Gets a list of all command check categories that are available for you as customer.
GET /checks/command-v2/categories Gets a list of all command check (version 2) categories that are available for you as customer.

Locations

Method Route Description
GET /checks/browser/locations Gets a list of all locations that are available for browser checks.
GET /checks/url/locations Gets a list of all locations that are available for URL (legacy version 1) checks.
GET /checks/url-v2/locations Gets a list of all locations that are available for URL (version 2) checks.
GET /checks/proxysniffer/locations Gets a list of all locations that are available for ZebraTester checks.
GET /checks/command/locations Gets a list of all locations that are available for Command checks.
GET /checks/command-v2/locations?protocol={protocol} Gets a list of all locations that are available for Command checks (version 2).
GET /checks/port/locations Gets a list of all locations that are available for Port checks.
GET /checks/ping/locations Gets a list of all locations that are available for Ping checks.

CheckResults

Method Route Description
GET /checks/{checkId}/results/{millisecondsUtc}?detail_level={detail_level} Gets a specific check result by a numeric java timestamp.
GET /checks/{checkId}/results?mostrecent={mostrecent}&detail_level={detail_level} Gets the most recent check results.
GET /checks/{checkId}/results?fromUtc={fromUtc}&toUtc={toUtc}&detail_level={detail_level} Gets check results between two dates.
GET /checks/proxysniffer/{checkId}/results/{resultId}/urldata?format={format} Gets a file that contains ZebraTester check result data.
POST /checks/proxysniffer/{checkId}/results/urldata Gets ZebraTester check results in json format by result ids.
GET /checks/proxysniffer/{checkId}/results/{resultId}/errorlog Gets an error log of the given ZebraTester check result.
GET /checks/browser/{checkId}/results/{resultId}/urldata?format={format} Gets a file that contains browser check result data.
GET /checks/browser/{checkId}/results/{resultId}/screenshots Gets information about screenshots for a browser check result.
GET /checks/browser/{checkId}/results/{resultId}/screenshots/{screenshotId} Gets information about a single screenshot for a browser check result.
GET /checks/browser/{checkId}/results/{resultId}/screenshots/{screenshotId}/file Gets a file with the screenshot for a browser check result.
POST /checks/browser/{checkId}/results/urldata Gets browser check results in json format by result ids.
GET /checks/browser/{checkId}/results/{resultId}/stepdata?format={format} Gets a file that contains browser check result data by step.
POST /checks/browser/{checkId}/results/stepdata Gets browser check results by step in json format by result ids.
POST /checks/browser/{checkId}/results Gets composite browser check results in json format.
POST /checks/url-v2/{checkId}/results Gets composite URL check (version 2) results in json format.

CheckJobs

Method Route Description
GET /checks/{checkId}/job DEPRECATED. Gets the current job status for a check.
POST /checks/{checkId}/job Executes a check.

ChecksAggregated

Method Route Description
GET /checks/{checkId}/aggregated?mostrecent={mostrecent}&detail_level={detail_level}&include_step_metrics={include_step_metrics}&scope={scope} For a specific check - gets aggregated data and SLA for the most recent periods in a scope.
GET /checks/{checkId}/aggregated?fromUtc={fromUtc}&toUtc={toUtc}&detail_level={detail_level}&include_step_metrics={include_step_metrics}&scope={scope} For a specific check - gets aggregated data and SLA between two dates.
GET /checks/aggregated?mostrecent={mostrecent}&detail_level={detail_level}&scope={scope} Gets aggregated data and SLA for the most recent periods in a scope. Note: Only the checks visible to the user will be retrieved.
GET /checks/aggregated?fromUtc={fromUtc}&toUtc={toUtc}&detail_level={detail_level}&scope={scope} Gets aggregated data and SLA between two dates. Note: Only data for checks visible to the user will be retrieved.

MonitorGroups

Method Route Description
GET /groups Gets a hierarchy of all monitor groups that are visible to you as a user or a customer depending on the request context.
POST /groups Creates a new monitor group.
PUT /groups/{groupId} Updates a monitor group.
DELETE /groups/{groupId} Deletes a monitor group by Id.

MonitorGroupChecks

Method Route Description
GET /groups/{groupId}/checks Gets a list of checks assigned to the monitor group.
POST /groups/{groupId}/checks Assigns checks to the monitor group.
DELETE /groups/{groupId}/checks Unassigns checks from the monitor group.

MonitorGroupUsers

Method Route Description
GET /groups/{groupId}/users Gets a list of users assigned to the monitor group.
POST /groups/{groupId}/users Assigns users to the monitor group.
DELETE /groups/{groupId}/users

Alerts

Method Route Description
GET /alerts?check_id={check_id}&severity={severity}&enabled={enabled}&target_type={target_type}&target_id={target_id} Gets alerts matching the provided parameters. Note: all parameters are optional.
GET /alerts/{alert_id} Gets the alert matching the provided id.
PUT /alerts/{alert_id} Updates the alert matching the provided alert_id.
DELETE /alerts/{alert_id}
POST /alerts/{alert_type} Creates a new alert of the provided alert_type.
GET /alerts/recipients Gets a list of all alert recipients visible to the customer.
GET /alerts/recipients/{recipient_id} Gets a information about the alert recipient matching the provided recipient_id.
PUT /alerts/recipient/{recipient_id} Updates the recipient (and associated SMS/email targets) matching the recipient_id.
POST /alerts/recipient Creates a new recipient with two targets: one SMS and one email.
GET /alerts/targets Gets a list of all alert targets visible to the customer.

Users

Method Route Description
GET /users/{user_guid} Returns customer's user by user GUID.
GET /users Returns all customer's users.
POST /users Creates a new user.
PUT /users Updates a user.
DELETE /users/{user_guid} Deletes a user.

Roles

Method Route Description
GET /roles Return user roles

Customers

Method Route Description
GET /customers/{customerId} Returns subcustomer by subcustomer's ID.
POST /customers Creates customer.
PUT /customers/{customerId}/subscription Updates customer's subscription.

CheckEvents

Method Route Description
GET /events?message={message}&severity={severity}&timestamp_utc_from={timestamp_utc_from}&timestamp_utc_to={timestamp_utc_to} Gets a list of events for the current user.

CustomEvents

Method Route Description
POST /custom_events Creates new custom event.
GET /custom_events/all?fromUtc={fromUtc}&toUtc={toUtc} Gets all custom events using optional filter.
GET /custom_events/{id} Gets custom event by Id.
PUT /custom_events/{id} Updates custom event.
DELETE /custom_events/{id} Deletes custom event.

Dictionaries

Method Route Description
POST /scenarios/proxysniffer/dictionaries Adds ZebraTester scenario custom dictionary.
GET /scenarios/proxysniffer/dictionaries/{dictionary_key} Gets a ZebraTester scenario custom dictionary by dictionary key. Custom dictionary can contain any data used by Proxy Sniffer scripts which needs to be stored separately from scripts.
PUT /scenarios/proxysniffer/dictionaries/{dictionary_key} Updates ZebraTester scenario custom dictionary.
DELETE /scenarios/proxysniffer/dictionaries/{dictionary_key} Delete a Proxy Sniffer scenario custom dictionary by dictionary key.

Messages

Method Route Description
GET /messages?active={active}&customerId={customerId} Gets a list of UI messages. UI messages are used for user notifications on announcements/information/warnings.
POST /messages Creates an UI message.
GET /messages/{id} Gets an existing UI message by Id.
PUT /messages/{id} Updates an existing UI message.
DELETE /messages/{id} Deletes an existing UI message.

BrowserScenarios

Method Route Description
GET /scenarios/browser/{scenario_id}?include_associated_check_ids={include_associated_check_ids} Gets info about a browser scenario.
PUT /scenarios/browser/{scenario_id} Updates a new browser scenario.
DELETE /scenarios/browser/{scenario_id} Deletes a browser scenario.
POST /scenarios/browser Gets a list of all browser scenarios that are visible to you as an administrator of the customer checks.
PUT /scenarios/browser Creates a new browser scenario.
GET /scenarios/browser/{scenario_id}/file Gets a file of a browser scenario.
POST /scenarios/browser/{scenario_id}/checks Associates checks with the browser scenario.
DELETE /scenarios/browser/{scenario_id}/checks Unassociates checks with the browser scenario.

ZebraTesterScenarios

Method Route Description
GET /scenarios/zebratester/{scenario_id}?include_associated_check_ids={include_associated_check_ids} Gets info about a ZebraTester scenario.
PUT /scenarios/zebratester/{scenario_id} Updates and/or recompile ZebraTester scenario.
DELETE /scenarios/zebratester/{scenario_id} Deletes a ZebraTester scenario.
POST /scenarios/zebratester Gets a list of all ZebraTester scenarios that are visible to you as an administrator of the customer checks.
PUT /scenarios/zebratester Creates a new ZebraTester scenario.
POST /scenarios/zebratester/versions Gets a list of all available ZebraTester compiler versions.
GET /scenarios/zebratester/{scenario_id}/file?compiled={compiled} Gets a file of a ZebraTester scenario.
POST /scenarios/zebratester/{scenario_id}/checks Associates checks with the ZebraTester scenario.

Tags

Method Route Description
GET /tags Get customer tags.