Interactive API client
The interactive API client lets you conveniently test and run API calls.
Overview
You can use the interactive API client to explore supported API calls and to modify data.
The entities you can access, and the operations you can perform, are based on the roles and permissions assigned to the API key that you use to sign in.
Note: You cannot use the interactive API client to perform site or space admin actions. Use the user interface or another REST API client instead.
You can make API calls directly from the interactive API client, or by copying examples into your code.
Use the REST API interactively
Follow these instructions to work with the REST API interactively.
-
Prerequisite: Obtain an API access client ID and secret from your admin. The API key must be assigned to a workspace. For details, see API access.
-
In the Help menu
, click Interactive API Client.
Tip: Another way to access the interactive API client is with this URL:
http://<server>:<port>/ui/swagger-ui/swagger.jsp
-
Enter the API client ID and secret.
Click Login.
-
If the API key is assigned to more than one workspace, select a workspace in the dropdown list.
-
Entity resources and operations are displayed. Only the entities and operations that are available for the role as defined in your API access key, and for the current workspace, are available.
Click Generic APIs to view all resources, or CI/CD APIs to see a subset of resources relating to continuous delivery.
Collapse or expand an entity resource to show / hide its operations (DELETE, GET, POST, PUT).
Caution: POST, PUT, and DELETE operations modify data, such as adding or editing defects or tests. You, and other users, can view these changes in in real time.
-
Select an entity and an operation, and enter parameter values. The interactive API client guides you by verifying your requests, for example, if you are missing a required field.
-
Click Execute to perform the operation using the parameters you have specified, or copy examples or syntax into your code.
For details on returned response codes, see Errors and status codes.
Retrieve interactive client metadata
You can export the interactive client's metadata using the following request:
http://<server>:<port>/api/shared_spaces/<space id>/workspaces/<work space id>/swagger
The interactive client uses the OpenAPI Specification (Version 2.0).
See also: