Configuration API

The Configuration API is written according to OpenAPI standards, and enables end users to view documentation for the API using their preferred OpenAPI tool, such as Swagger, Postman, or RediDoc. You can either view the Configuration API documentation directly in the product (/login), or download the YAML file and use a tool of your choice to view the documentation.

View the Configuration API Documentation in /login

Log in to your site (for example, https://example.com/login/apidocs.html) and enter your credentials. There are lists, descriptions, and examples for all available configuration APIs.

Access Configuration API Documentaton directly from /login

View Configuration API Documentation

if you are already logged in to the administrative interface, you can click Management on the left menu, then click the API Configuration tab. Click View the Confiiguration API Documentation.

Access the YAML file via API

By following the steps below and referring to the documentation for the OpenAPI tool of your choice, you can view the API documentation and even try out features of the API using an intuitive browser user interface.

  1. Go to /login > Management > API Configuration.
  2. Under API Accounts, click Add.
  3. Enter a name to identify your new API account.
  4. Make sure the Configuration API > Allow Access box is checked.
  5. Click Save.
  6. Download and install your favorite software for running API calls. Please refer to the documentation for your selected software before proceeding, if needed.
  7. In /login > Management > API Configuration, select the new API account you just created and click the edit icon.
  8. Copy the OAuth Client ID and paste it into your selected software.
  9. Back in /login, click Generate New Client Secret, copy it, and paste it into you selected software.
  10. Click Save to save your API account.
  11. Import the OpenAPI.yaml file from your site, using your preferred OpenAPI tool. The OpenAPI.yaml file can be accessed by creating a new GET request with the URL format https://example.com/api/config/v1/openapi.yaml. Once imported, the documentation for the Configuration APIs will be automatically generated. Follow the instructions in your API call software in order to complete these steps.

Download the YAML file

Download the YAMl file

Alternatively, you can download the YAML file by clicking the Download the Configuration API's OpenAPI YAML file