Loading...

Aviso:

Para brindarle información de soporte completa de manera más rápida, el contenido de esta página ha sido traducido al español mediante traducción automática. Para consultar la información de soporte más precisa, consulte la versión en inglés de este contenido.

Introducción a Catalyst API

Descripción general

Catalyst API ofrece una amplia gama de funcionalidades que permiten a los desarrolladores de aplicaciones trabajar de forma remota con los componentes de Catalyst en su aplicación. Puedes crear y gestionar tu aplicación de Catalyst utilizando las APIs, así como realizar operaciones remotas en ella, de manera similar a trabajar con la consola web de Catalyst.

Por ejemplo, puedes realizar operaciones como insertar datos en una tabla en Data Store o ejecutar una función utilizando las APIs correspondientes.

Catalyst implementa los estándares de REST API y admite solicitudes y respuestas HTTP para acceder a sus recursos. Los recursos de Catalyst se exponen a través de sus URLs de endpoint, y los clientes HTTP pueden acceder a estos endpoints utilizando sus APIs específicas.

Catalyst implementa los siguientes principios básicos de REST API:

  • La URL de endpoint de cada instancia de un recurso de Catalyst es única.
  • El método HTTP en la solicitud determina la operación que se realizará sobre el recurso.
  • La información adicional del payload se pasa como parámetros en la solicitud. Estos contienen los detalles de la operación que se va a realizar.
  • Cada solicitud genera una respuesta de Catalyst.

Puedes consultar las secciones de formato de solicitud y formato de respuesta para obtener detalles y ejemplos.

Nota:Puedes implementar las funcionalidades de Catalyst en tu aplicación utilizando el SDK proporcionado para cada entorno de programación. Los SDKs de Catalyst ofrecen mayor comodidad y facilidad en el proceso de creación de tu aplicación, y te permiten realizar todas las operaciones de Catalyst que puedes realizar al trabajar con la API. Consulta la documentación de ayuda del SDK de los entornos de programación compatibles con Catalyst: Java SDK, NodeJS SDK, Web SDK, Android SDK, iOS SDK, Flutter SDK.

Requisitos previos

Antes de comenzar a trabajar con Catalyst API, debes asegurarte de que se cumplan los siguientes requisitos previos:

  • Una cuenta de usuario de Zoho válida: Asegúrate de tener una dirección de correo electrónico y contraseña de inicio de sesión de Zoho válidas. Puedes registrarte para obtener una cuenta de Zoho aquí.
  • Un token de autenticación: Debes obtener un access_token de OAuth válido para acceder a Catalyst API.

Las páginas de ayuda en la sección Autenticación OAuth 2.0 te guiarán en el proceso de comprensión y obtención de tokens de autenticación.

Todas las APIs de Catalyst serán accesibles para un usuario de Catalyst con el rol de App Administrator (desarrollador de aplicaciones de Catalyst) después de obtener su access_token. Todos los colaboradores de un proyecto en particular también podrán ejecutar todas las APIs de Catalyst utilizando su access_token.

Sin embargo, solo ciertas operaciones son accesibles para los usuarios con el rol de App User, es decir, los usuarios finales de una aplicación de Catalyst con autenticación de usuario de Catalyst. El usuario final solo puede realizar operaciones relacionadas con el acceso a datos específicos de la aplicación, y no operaciones que modifiquen la aplicación. Cada página de ayuda de la API te proporcionará información sobre los permisos de ejecución definidos para ella.


Nota:

  • Si deseas ejecutar operaciones de Catalyst sin generar tokens de autenticación, puedes utilizar el SDK de Catalyst en su lugar.

  • Actualmente, Catalyst no admite un proceso de autenticación de API separado para usuarios finales de aplicaciones de Catalyst. Si implementas el SDK de Catalyst en el código de tu aplicación, la autenticación se gestiona automáticamente como una autenticación de App Administrator. Para utilizar Catalyst API de forma independiente, debes seguir los pasos descritos en la sección Autenticación OAuth 2.0 para generar tokens de autenticación OAuth.