Search

Public API

Overview

Use cases

Accessing Public API/Swagger UI

Adding a system access token

Public API secrets

Additional resources (examples)

Overview

The primary use case for public APIs is to import data into other applications, such as Splunk. This way you can merge Login Enterprise data in your preferred dashboard or data collector to have all data centralized.

The public API of Login Enterprise is built on the REST Web API standard. You can use the APIs to pull data from the Login Enterprise instance. This data can then be used for your specific goal.

Important notes:

  • Applies to Appliance version 4.5.x and higher: V1 and 2 of the Public API have been removed.
  • Applies to Appliance version 4.6 and higher: V3 of the public API has been removed.

Use cases

Bulk administration

Using the API makes managing your Login Enterprise environment at scale much easier. Instead of manually handling one-off tasks in the web interface, you can create, modify, and maintain multiple Tests or user accounts in a fraction of the time. For example, you might rely on tools like Postman to send automated requests that create or update a range of Tests in a single go.

Data retrieval and external analysis

The API provides quick, programmatic access to your Login Enterprise instance's Test results and performance metrics. This data can be fed directly into external analytics or reporting platforms—such as Microsoft Power BI—to generate custom dashboards, track long-term trends, and compare different Test sets. This approach helps ensure you’re getting the most out of your data, whether you’re looking for insights or just need a better way to visualize results.

Scheduling, starting, and stopping Tests

By tapping into the API’s capabilities, you can set up Test runs according to your own schedule, kick off Tests on demand, or pause them as needed—all without clicking through the web interface. This gives you the flexibility to integrate testing into your existing workflows and processes, making it easier to keep Tests running smoothly at all times.

Integration with third-party systems for alerts and maintenance

The API also simplifies integration with platforms like ServiceNow, making it possible to automatically create and manage ITSM tickets when critical issues arise. If a published desktop resource

Accessing Public API/Swagger UI

To access the Public API in the Login Enterprise, follow these steps:

  1. Log in to the Login Enterprise with your credentials
  2. In the Sidebar menu, scroll down and find External notifications.

    14.png

  3. In External notifications > tab bar menu, select Public API.

    15.png

  4. In Public API, click Public API documentation (this will redirect you to the API Reference).

    16.png

  5. Under Download OpenAPI specification > v7.0 preview, click Documentation (ReDoc). 

Frame 55.png


To interact with the Public API through the browser, in the v7.0 preview, click API Console (Swagger).

Frame 8.png

Adding a system access token

To add a new system access token:

  1. In Public API, click the “+“ on the top right.

Frame 57.png

2. In the Adding a system access token window, provide a description (name) and the access level type for your token.

Frame 58.png

  • Read-Only
    • Only able to retrieve collected data and configurations.
  • Schedule
    • Includes Read-Only functionality and adds enable and disable tests.
  • Configuration
    • Includes Read-Only and Schedule functionality and adds complete read and write capabilities.

3. Click Save to apply the changes. The new access token will be available instantly.

For security purposes, this is the only time you can view the Public API token. Make sure you create a backup of this key, otherwise you will need to recreate it.

Frame 59.png

Public API secrets

An API secret is used for authentication against Login Enterprise Public APIs.

By default there are two users (clients) with different permissions, one is for reading information from the API, and the other is used for simple control actions.

Note, however, that this way of authentication is now deprecated.

  • ReadonlyPublicAPI
    • Reads data from results and configuration.
  • ControlPublicAPI
    • Allows starting and stopping environment schedules (Tests). That is, starting and stopping a Load Test.

Frame 56.png

If your secret is compromised, you can renew it to eliminate possible security breaches. At that moment the old secret is discarded and cannot be used for authentication.

To regenerate a new secret, click Refresh next to your key or delete the old key.

Frame 60.png


Additional resources (examples)