Warning: Use the Try it Out feature in the API Explorer with caution. It modifies your Relativity instance database by updating or deleting data that you may not be able to recover. Only use this feature if you have want to make updates to your database instance and have vetted these changes.

API Explorer

The API Explorer is an interactive application used for making calls to Kepler service endpoints directly in Relativity. It includes modules used to perform CRUDQ operations on a Relativity resource. Each module contains the URLs for service endpoints, the ability to view fields used in the payload request, and information about fields returned in a response.

The API Explorer consumes an OpenAPI file generated using Open API 3.0 specification, which is a common standard for REST APIs. After you install the API Explorer, it searches for an OpenAPI file in each application RAP file installed in your Relativity instance. It then reads the file and populates a web interface, so that you can interact with the APIs supported by that specific application. For more information, see What Is OpenAPI? on the Swagger website.

This page contains the following information:

Before you begin

Complete the following tasks to set up the API Explorer:

Quickstart steps

The quickstart steps include high-level information about how to navigate through the API Explorer and make REST calls. You may want to use these instructions if you are already familiar with using OpenAPI documentation. For additional information about available services and requirements for making REST calls, see Relativity Services in REST.

If you would like detailed navigation instructions and conceptual information, see the API Explorer tutorial.

Warning: Use the Try it Out feature in the API Explorer with caution. It modifies your Relativity instance database by updating or deleting data that you may not be able to recover. Only use this feature if you have want to make updates to your database instance and have vetted these changes.
  1. Navigate to the API Explorer in the workspace where you installed it.
  2. In the left navigation pane, click on an application associated with the API that you want to use.
  3. Click on the API that you want to use. The API Explorer displays a list of available endpoints with their HTTP methods and URLs.

    (Click to expand)

    API Explorer

  4. To view the header parameters, and the request body, click on an endpoint.
  5. Click Try it out to set values for the header parameters and the fields in the request body.

    (Click to expand)

    Try it out button

  6. Enter values for the parameters and fields and then click Execute to make a REST call.

    Note: If you execute a REST call, your instance database may be modified. You can change, delete, or corrupt data using the API Explorer interface.

  7. Review the response. For more information, see View the response.

    (Click to expand)

    Response

API Explorer tutorial

The API Explorer tutorial provides detailed information for each step used in the process for inspecting a REST API. It uses the Object Manager service to step through the features of the API Explorer, while also explaining key concepts underlying REST calls. For example, it describes the parameters and fields that you need set for a specific endpoint on the Object Manager service. If you need only minimal instructions for navigating in the API Explorer, see Quickstart steps.

This tutorial includes the following sections:

Select an API to inspect

In the API Explorer, you can interact with an API by selecting it, and then choosing the version that you want to use for REST calls. Complete the following steps to select the API and its respective version:

  1. Navigate to the API Explorer in the workspace where you installed it.

    The left navigation pane lists applications that have OpenAPI files describing the API for an application.

  2. In the left navigation pane, click on an application. For example, click Relativity.ObjectManager.

    The center pane may display the available versions of the API used for the application. In this example, the center pane displays only one version of the Object Manager API.

    (Click to expand)

    Versioned services

  3. Click on the version of the API that you want to use.

    The center pane now displays a list of available endpoints that you can use to make REST calls for this versioned service. The HTTP method and route for each endpoint is displayed. This example uses Object Manager v1, but you can easily switch to Object Manager v2.

    (Click to expand)

    Service routes

View the parameters and request body

A REST request includes header information, and may include key-value pairs in a JSON payload in the body. To view the header parameters and the request body, click on an endpoint. For example, click on the read endpoint for the Object Manager API as shown in the following screen shot:

(Click to expand)

Request body

The request page contains the following information:

Set the parameters for the HTTP header

Before making a REST call, you must set the values for the required parameters and fields in the request body. Click Try it out to set the values that you want to use.

Warning: Use the Try it Out feature in the API Explorer with caution. It modifies your Relativity instance database by updating or deleting data that you may not be able to recover. Only use this feature if you have want to make updates to your database instance and have vetted these changes.

(Click to expand)

Try it out button

The Parameters section now displays a form listing the required values that you need to add. For the read endpoint on the Object Manager service, enter the following value in this form:

(Click to expand)

HTTP header settings

Set the fields in the request body

To set the fields in the request body, scroll to the Request body section of the form. For the read endpoint on the Object Manager service, enter the following field values:

(Click to expand)

Request body settings

For more information about field values, see Object Manager service.

Make the REST call

After you have set the parameters and field values, you are ready to make a request to the service. Click Execute.

Note: If you execute a REST call, your instance database may be modified. You can change, delete, or corrupt data using the API Explorer interface.

View the response

A response is returned after a REST call finishes executing. It includes a status code indicating whether the call was successful, HTTP headers with general information about the response, and possibly a response body with any requested data. For more information, see Describing Responses on the Swagger website.

Review the following response:

(Click to expand)

Response

In the API Explorer, the Responses section includes the following subsections:

Community Updates

Aero Developer FAQ Evolving the Platform Most recent release notes
Learn more Learn more Learn more

Additional Resources

   
Access Third-Party Tools with GitHub     Create .NET Apps Faster with NuGet
Visit github     visit nuget