This section shows how to use Postman to make API calls to Lightstep.
- An active Lightstep organization and project
- Access to your Lightstep Public API Keys
- The Postman client installed
- Basic knowledge of APIs and JSON
- Download the Lightstep Postman Collection (pre-configured API templates)
A Postman Collection lets you group individual requests together for easy editing and re-use.
- Open Postman. Click on File > Import or click on the Import button in the upper left of Postman.
- Select the lightstep_postman_collection.json file downloaded in Step 1.
The Lightstep API is now available as a collection in Postman. A full list of available Lightstep API calls is structured by folder in the left pane of Postman.
Note: The following section is required for the API calls to work.
The collection uses Postman Environment variables to set API keys and other values that might remain static most of the time, for example
Follow these steps to setup your API keys for your collection.
- Click the Manage Environments gear icon in the upper right corner of Postman.
- Click Add and enter an Environment Name. For example, you can name your environment Lightstep or Lightstep-YourOrgName.
- In the table, add the variable
lightstep_api_key. In the Current Value column, enter your actual LightStep API Key.
- If you have access to multiple organizations and projects, you can also choose to add the
projectvariables and/or setup multiple environments.
- Once an Environment is set up, you can choose it from the dropdown in the upper right corner of Postman.
After setup is complete, you are ready to begin making API calls. In the Lightstep Public API collection in the left sidebar, there are multiple subfolders for each type of API category listed in the Lightstep Public API Reference. You can test your API access by using the API calls under the Test folder.
Some API calls include path, query, or body parameters. When you select an API call from the left sidebar, you can edit the parameters in the tab that opens on the right before sending the API call. Refer to the Lightstep Public API Reference for more details about each API call and its parameters.
For more information on using Postman, refer to the guides here.