OpenAPI specification

We use OpenAPI specification to describe all DataClarity‘s APIs. Each OpenAPI file is visualized with Swagger, a fully interactive documentation tool that allows you to:

  • Visualize and interact with the API resources using your data.

  • Try out the API before integrating it into your code.

  • Download the API documentation (OpenAPI definition files version 3.0.3)

For more information on how to test APIs, see Testing the APIs.

API reference documentation per each component is provided with the Platform’s installation, where “localhost” is the name or IP address that was configured for the Platform.

ComponentDocumentation
Data Preparation API
  • Swagger: https://localhost/dp/swagger-ui/index.html

  • Additional documentation with usage and SDK samples: https://localhost/dp

Storyboards API

  • Swagger: https://localhost/sb/swagger-ui/index.html

  • Additional documentation with usage and SDK samples: https://localhost/sb

Scheduler API

  • Swagger: https://localhost/scheduler/swagger-ui/index.html

  • Additional documentation with usage and SDK samples: https://localhost/scheduler

Notification API

  • Swagger: https://localhost/notification/swagger-ui/index.html

  • Additional documentation with usage and SDK samples: https://localhost/notification

API entry points

The base URL points to the root API resources that you can use to interact with the API. The Swagger endpoint reference shows the method, path, resource, and parameters that must be appended to the base URL to form a request.

The following are the examples of well-formed REST URLs:

GET https://example.com/dp/​api​/v1​/aiconnections

DELETE https://example.company.com/sb/api/v1/storyboards/163596123486617769

The base URLs for each component are the following.

Component

Base URL

Storyboards API

https://localhost/sb/

Data Preparation API

https://localhost/dp/

Notification API

https://localhost/notification/

Scheduler API

https://localhost/scheduler/

Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.