--- title: "Implementar Catalyst SDK" url: https://docs.catalyst.zoho.com/es/serverless/help/appsail/implement-catalyst-sdk/ description: "Catalyst AppSail es una plataforma completamente gestionada de Catalyst Serverless que te permite desarrollar y desplegar servicios web en runtimes gestionados de Java, Node.js y Python, o de runtimes personalizados como imágenes OCI en la nube con facilidad." last_updated: 2026-03-30T08:10:30Z service: Serverless type: general --- # Implementar Catalyst SDK en AppSail Catalyst te permite implementar los paquetes SDK de los entornos de desarrollo soportados en tus aplicaciones de AppSail para [runtimes gestionados por Catalyst](https://docs.catalyst.zoho.com/es/serverless/help/appsail/catalyst-managed-runtimes/key-concepts/). Esto te permite aprovechar otros servicios y componentes de Catalyst en la funcionalidad de tu aplicación. Puedes implementar los SDKs de desarrollo de varios entornos de programación en tu aplicación como se especifica a continuación. > **Nota:** Esto solo está disponible para servicios web construidos para un runtime gestionado por Catalyst soportado. No podrás implementar el SDK de Catalyst para aplicaciones desplegadas como imágenes OCI a través de [runtime personalizado](https://docs.catalyst.zoho.com/es/serverless/help/appsail/custom-runtimes/overview/). ### Implementar Catalyst Java SDK Puedes descargar el paquete de Catalyst Java SDK desde la configuración de [Developer Tools](https://docs.catalyst.zoho.com/es/getting-started/set-up-a-catalyst-project/developer-tools/) en tu consola de Catalyst e incluirlo en el código fuente de tu aplicación. Luego puedes implementar el Catalyst Java SDK en el código de tu aplicación e inicializarlo. Consulta [la ayuda de Catalyst Java SDK](https://docs.catalyst.zoho.com/es/sdk/java/v1/overview/) para detalles sobre las diversas funcionalidades del conjunto de herramientas del SDK y fragmentos de código de ejemplo. Los pasos para implementar e inicializar el SDK de Catalyst para diferentes versiones de API de servlets Java se demuestran con códigos de ejemplo a continuación. En todos los casos, Catalyst requiere que implementes la interfaz `AuthHeaderProvider` del paquete de Catalyst Java SDK. La implementación define el método `getHeader()` que devuelve el valor del encabezado de la solicitud. Luego puedes pasar un objeto de la clase de implementación al método `init()`, para inicializar el SDK. #### Versiones de Java Servlet API <=4 Código de ejemplo para aplicaciones Java que usan servlets Java de versiones de API menores o iguales a 4.0 (`[javax.servlet](https://docs.oracle.com/javaee%2F7%2Fapi%2F%2F/javax/servlet/package-summary.html)`): **Clase de implementación:** ```java package com.zoho.catalyst.appsail.demo.utils; import javax.servlet.http.HttpServletRequest; import com.zc.auth.AuthHeaderProvider; public class AuthProviderImpl implements AuthHeaderProvider { HttpServletRequest request; public AuthProviderImpl(HttpServletRequest request) { this.request = request; } @Override public String getHeaderValue(String key) { return request.getHeader(key); } } ``` **Inicialización:** ```json AuthProviderImpl authProviderImpl = new AuthProviderImpl(req); CatalystSDK.init(authProviderImpl) ``` #### Versiones de Java Servlet API >=5 Código de ejemplo para aplicaciones Java que usan servlets Java de versiones de API mayores o iguales a 5.0 (`[jakarta.servlet](https://mvnrepository.com/artifact/jakarta.servlet)`): **Clase de implementación:** ```java import com.zc.auth.AuthHeaderProvider; import jakarta.servlet.http.HttpServletRequest; public class AuthProviderImpl implements AuthHeaderProvider { private HttpServletRequest request; AuthProviderImpl(HttpServletRequest request) { this.request = request; } @Override public String getHeaderValue(String s) { return request.getHeader(s); } } ``` **Inicialización:** ```json CatalystSDK.init(new AuthProviderImpl((HttpServletRequest) servletRequest)); ``` Si estás desarrollando una aplicación Java con la herramienta de compilación [Maven](https://maven.apache.org/), puedes incluir el Catalyst Java SDK como una dependencia en el archivo de configuración de Maven ([`pom.xml`](https://maven.apache.org/guides/introduction/introduction-to-the-pom.html)), en lugar de descargar y agregar el SDK en tu código fuente manualmente. Para agregar el SDK de Catalyst en un proyecto Maven, simplemente agrega el repositorio de Zoho (publicado en [MvnRepository](https://mvnrepository.com/)) en el archivo `pom.xml` como se muestra a continuación: ```json <repositories> <repository> <id>java-sdk</id> <url>https://maven.zohodl.com</url> </repository> </repositories> ``` Luego puedes agregar el Java SDK como una dependencia en pom.xml como se muestra a continuación: ```json <dependencies> <dependency> <groupId>com.zoho.catalyst</groupId> <artifactId>java-sdk</artifactId> <version>1.15.0</version> </dependency> </dependencies> ``` ### Implementar Catalyst Node.js SDK Puedes instalar el paquete de Catalyst Node.js SDK ejecutando el siguiente comando en tu terminal e incluyéndolo en el código fuente de tu aplicación: ```json npm install zcatalyst-sdk-node --save ``` Esto instalará la última versión soportada del Node.js SDK. También puedes instalar una versión soportada específica de esta manera: ```json npm install zcatalyst-sdk-node@2.1.1 --save ``` Luego puedes inicializar el Node.js SDK en el código de tu aplicación como se muestra en el código de ejemplo a continuación. Esto pasa el objeto de solicitud al método `initialize()`. ```javascript const catalyst = require('zcatalyst-sdk-node') const express = require('express') const app = express() app.get((req, res) => { let catalystApp = catalyst.initialize(req); //Tu código va aquí }) app.listen(process.env("X_ZOHO_CATALYST_LISTEN_PORT") || 9000) ``` Consulta [la ayuda de Catalyst Node.js SDK](https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/overview/) para más detalles. La documentación del SDK también proporciona fragmentos de código de ejemplo para todas las funcionalidades soportadas. ### Implementar Catalyst Python SDK Puedes instalar el SDK de Catalyst Python para tu solución de AppSail ejecutando el siguiente comando en tu terminal e incluyéndolo en el código fuente de tu aplicación: ```json pip install zcatalyst-sdk -t . ``` Luego puedes importar el Python SDK en tu código para tu aplicación de Catalyst. El SDK necesitará ser inicializado con el objeto de solicitud antes de cada solicitud. A continuación se muestra un fragmento de código de ejemplo para importar e inicializar el Python SDK en una aplicación web Flask: ```python from flask import Flask, request, g import os import zcatalyst_sdk from zcatalyst_sdk.catalyst_app import CatalystApp app = Flask(__name__) @app.before_request def before_request(): if request.path.startswith('/admin'): return 'Unauthorized', 401 # si el usuario está autorizado g.zc_app = zcatalyst_sdk.initialize(req=request) @app.route('/') def index(): return 'Web App with Python Flask!' @app.route('/cache') def cache(): app: CatalystApp = g.zc_app resp = app.cache().segment().put('key', 'value') return resp, 200 listen_port = os.getenv('X_ZOHO_CATALYST_LISTEN_PORT', 9000) app.run(host='0.0.0.0', port = listen_port) ``` Consulta [la ayuda de Catalyst Python SDK](https://docs.catalyst.zoho.com/es/sdk/python/v1/overview/) para detalles sobre las diversas funcionalidades del conjunto de herramientas del SDK y fragmentos de código de ejemplo.