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 access client ID and secret that you use to sign in.

Note: To perform site admin actions (such as setting configuration parameters), log in as the site admin using a REST API client tool. You cannot use the interactive API client to perform these actions. For details, see Authentication.

You can make API calls directly from the interactive API client, or by copying examples into your code.

Back to top

Use the REST API interactively

Follow these instructions to work with the REST API interactively.

  1. Prerequisite: Obtain an API access client ID and secret from your admin. For details, see API access.

  2. 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

  3. Enter your client ID and secret (not your user name and password).

    Click Login.

  4. Select the workspace.

  5. 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.

  6. 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.

  7. 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.

Back to top

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).

Back to top

See also: