Catalyst API

Overview

Catalyst API offers a wide range of functionalities that enable an application developer to work with the Catalyst components remotely in their application. You can build and manage your Catalyst application using the APIs, as well as perform remote operations on it, similar to working with it using the Catalyst web console.

For example, you can perform operations such as inserting data in a table in the Data Store, obtaining details of a folder in the File Store, or executing a function using the respective APIs.

Catalyst implements REST API standards, and supports HTTP requests and responses for accessing its resources. Catalyst resources are exposed through their endpoint URLs, and the HTTP clients can access these endpoints using their specific APIs.

Catalyst implements the following basic REST API principles:

  • The endpoint URL of each instance of a Catalyst resource is unique.
  • The HTTP method in the request dictates the operation to be performed on the resource.
  • Additional payload information is passed as parameters in the request. They contain the details of the operation to be performed.
  • Each request initiates a response from Catalyst.

You can refer to the request format and response format sections for details and examples.

Note: You can implement Catalyst functionalities in your application using the SDK provided for each programming environment. Catalyst SDKs provide better convenience and ease in your application building process, and enable you to perform all Catalyst operations that you can perform while working with the API. Refer to the SDK help documentations of the supported programming environments in Catalyst: Java SDK, NodeJS SDK, Web SDK, Android SDK, iOS SDK.

 

Prerequisites

 

Before you begin working with Catalyst API, you must ensure that the following prerequisites are satisfied:

  • A valid Zoho user account: Ensure that you have a valid Zoho login email address and password. You can sign up for a Zoho account here.
  • An authentication token: You must obtain a valid OAuth access_token to access Catalyst API.

The help pages in OAuth 2.0 Authentication section will guide you in the process of understanding and obtaining authentication tokens.

All Catalyst APIs will be accessible to a Catalyst user in the App Administrator role, (Catalyst application developer) after they obtain their access_token. All the collaborators of a particular project will also be able to execute all Catalyst APIs using their access_token.

However, only certain operations are accessible for the users in the App User role, i.e., the end users of a Catalyst application with a Catalyst user authentication. The end user can only perform operations related to accessing specific application data, and not operations that modify the application. Each API help page will provide you with information on the execution permissions defined for it.

Note:
  • If you want to execute Catalyst operations without generating any authentication tokens, you can use Catalyst SDK instead.
  • Catalyst currently does not support a separate API authentication process for end users of Catalyst applications. If you implement Catalyst SDK in your application code, the authentication is automatically handled as an App Administrator authentication. To use Catalyst API independently, you must follow the steps described in the OAuth 2.0 Authentication section to generate OAuth authentication tokens.