---
title: "Integrar SDK en aplicaciones de terceros"
url: https://docs.catalyst.zoho.com/es/sdk/python/v1/integrate-sdk-in-third-party-apps/
last_updated: 2026-08-17T12:16:04Z
service: All Services
type: general
related_links:
  - name: "Catalyst Environments"
    url: /es/deployment-and-billing/environments/introduction/
  - name: "Catalyst Cloud Scale Authentication"
    url: /es/cloud-scale/help/authentication/introduction/
  - name: "Catalyst Cloud Scale Stratus"
    url: /es/cloud-scale/help/stratus/introduction/
---

# Integración del SDK de Python de Catalyst en aplicaciones de terceros
Puedes integrar y usar los métodos del SDK de Python de Catalyst en aplicaciones desplegadas fuera del entorno de Catalyst. Por ejemplo, una aplicación React alojada en Vercel usando un backend Flask (ejecutándose fuera de Catalyst) puede subir documentos a [Catalyst Cloud Scale Stratus](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/introduction/) o un pipeline de datos ejecutándose en Amazon Web Services EC2 puede enviar datos de clientes a [Catalyst Cloud Scale Data Store](https://docs.catalyst.zoho.com/es/cloud-scale/help/data-store/introduction/) usando consultas de [Catalyst Cloud Scale ZCQL](https://docs.catalyst.zoho.com/es/cloud-scale/help/zcql/introduction/) mediante las operaciones respectivas del SDK de Python.
Estos son solo algunos casos de uso comunes donde las aplicaciones externas pueden interactuar de forma segura con los componentes de Catalyst sin estar desplegadas dentro de la plataforma de Catalyst.
Hemos proporcionado el fragmento de código para ayudarte a integrar el SDK de Python de Catalyst con aplicaciones externas. Sin embargo, antes de implementar el código en tu aplicación, revisa los siguientes requisitos previos.
### Requisitos previos para la integración del SDK
Para integrar el SDK de Python de Catalyst con tu aplicación externa, asegúrate de tener la siguiente información:
* **Project ID:**
El identificador único de tu [proyecto de Catalyst](https://docs.catalyst.zoho.com/es/getting-started/catalyst-projects/).
* **ZAID (Zoho Account ID):**
Un identificador de portal único asignado por Catalyst para vincular tu proyecto con el [entorno de Catalyst](https://docs.catalyst.zoho.com/es/deployment-and-billing/environments/introduction/) ([desarrollo](https://docs.catalyst.zoho.com/es/deployment-and-billing/environments/development-environment/) o [producción](https://docs.catalyst.zoho.com/es/deployment-and-billing/environments/production-environment/)).
* **Environment:**
El [entorno objetivo](https://docs.catalyst.zoho.com/es/deployment-and-billing/environments/introduction/) ([desarrollo](https://docs.catalyst.zoho.com/es/deployment-and-billing/environments/development-environment/) o [producción](https://docs.catalyst.zoho.com/es/deployment-and-billing/environments/production-environment/)) de tu proyecto de Catalyst.
* **OAuth Credentials:**
Esto es necesario para autenticar y autorizar tu aplicación externa a través del portal de self-client de Catalyst para acceder a los componentes de Catalyst. Necesitarás lo siguiente:
1. Client ID
2. Client Secret
3. Refresh Token
Después de obtener estos valores, puedes proceder con la integración del SDK de Python en tu aplicación.

### Pasos para integrar
Ahora, veamos cómo obtener cada uno de estos valores y configurarlos en el fragmento de código.
Asegúrate de seguir los pasos descritos a continuación:
1. **Crear un proyecto en la consola de Catalyst:** Puedes crear un nuevo [proyecto de Catalyst](https://docs.catalyst.zoho.com/es/getting-started/catalyst-projects/#introduction-to-catalyst-projects) en la [consola](https://console.catalyst.zoho.com/) usando los pasos mencionados en [esta página de ayuda](https://docs.catalyst.zoho.com/es/getting-started/catalyst-projects/#create-a-catalyst-project).
2. **Recuperar el Project ID:** Una vez que hayas creado tu proyecto, necesitarás tomar nota del **Project ID**. El Project ID es el ID único de tu proyecto que se creará automáticamente durante la creación del proyecto.
Puedes encontrarlo haciendo clic en el ícono **Settings** ubicado en la esquina superior derecha de la consola de Catalyst.
![click-settings](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/click-settings.webp)
En la pantalla de **Settings**, navega a **Project Settings** y selecciona **General**. Puedes ver y tomar nota del Project ID desde esta sección, como se muestra en la captura de pantalla a continuación.
![project-id](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/project-id.webp)

3. **Recuperar el ZAID:** Necesitarás incluir el **ZAID** de tu proyecto en el fragmento de código proporcionado en esta sección. El **ZAID** es un identificador de portal único asignado por Catalyst para vincular tu proyecto con el entorno de Catalyst requerido ([desarrollo](https://docs.catalyst.zoho.com/es/deployment-and-billing/environments/development-environment/) o [producción](https://docs.catalyst.zoho.com/es/deployment-and-billing/environments/production-environment/)).
[Aprende más sobre los entornos de Catalyst](https://docs.catalyst.zoho.com/es/deployment-and-billing/environments/introduction/).
Para recuperar el ZAID, es obligatorio configurar el componente [Catalyst CloudScale Authentication](https://docs.catalyst.zoho.com/es/cloud-scale/help/authentication/introduction/). Sin embargo, usarlo para el flujo de autenticación de tu aplicación es opcional. Para obtener el ZAID:
i. Navega al servicio [Catalyst CloudScale](https://docs.catalyst.zoho.com/es/cloud-scale/) en la consola y bajo **Security & Identity**, selecciona **Authentication**.
![select-authentication](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/select-authentication.webp)

ii. Necesitarás configurar [Native Catalyst Authentication](https://docs.catalyst.zoho.com/es/cloud-scale/help/authentication/native-catalyst-authentication/introduction/), donde Catalyst gestiona todo el proceso de autenticación por ti, eliminando la necesidad de cualquier codificación adicional o gestión de infraestructura de tu parte.
iii. Haz clic en **Set Up**.
![click-setup](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/click-setup.webp)

iv. Selecciona el tipo **Hosted authentication**, que te permite alojar tu elemento de inicio de sesión en páginas dedicadas de tu aplicación. Puedes configurar y diseñar la autenticación desde la consola, y Catalyst la renderizará para tu aplicación y manejará todos los requisitos del backend.
![hosted-authentication](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/hosted-authentication.webp)

v. Debes habilitar la opción [Public Signup](https://docs.catalyst.zoho.com/es/cloud-scale/help/authentication/public-signup/) para mostrar la función de registro en tu componente de inicio de sesión, permitiendo que nuevos usuarios se registren y accedan a tu aplicación. Puedes consultar la [página de ayuda de hosted authentication](https://docs.catalyst.zoho.com/es/cloud-scale/help/authentication/native-catalyst-authentication/hosted-authentication-type/introduction/) para una guía de configuración detallada paso a paso.
![public-signup](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/public-signup.webp)

vi. En la pantalla de confirmación, haz clic en **Yes, proceed**.
![confirmation](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/confirmation.webp)

vii. Puedes habilitar cualquiera de las opciones de inicio de sesión social soportadas listadas a continuación y recuperar el valor del **ZAID** correspondiente del proveedor seleccionado.
[Aprende cómo obtener el ZAID para un inicio de sesión social específico](https://docs.catalyst.zoho.com/es/cloud-scale/help/authentication/social-logins/configuring-social-logins/).

> **Note:** Los proveedores de inicio de sesión social, como Google, Microsoft, LinkedIn y Facebook, son compatibles para recuperar el ZAID; sin embargo, el inicio de sesión con Zoho no es compatible para este propósito.

![socials](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/socials.webp)

[Aprende más sobre este tipo de hosted authentication](https://docs.catalyst.zoho.com/es/cloud-scale/help/authentication/native-catalyst-authentication/hosted-authentication-type/introduction/).

4. **Registrar una aplicación Self Client:** Necesitarás obtener el **Refresh Token**, **Client ID** y **Client Secret** para autenticar y autorizar tu aplicación para acceder a los recursos de Catalyst en nombre del usuario de tu aplicación.
Para obtener los elementos requeridos mencionados anteriormente, primero debes registrar tu aplicación como self-client en la [consola de API](https://api-console.zoho.com).
i. Inicia sesión en la consola de API y haz clic en **Self-client**.
![self-client](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/self-client.webp)

ii. Configura el alcance de la aplicación self-client basándote en las operaciones que tu aplicación necesita realizar en Catalyst.
[Aprende más sobre los alcances disponibles](https://docs.catalyst.zoho.com/es/api/oauth2/scopes/#Scopes).
iii. Proporciona el alcance requerido, agrega una descripción apropiada y haz clic en **Create**.
![create](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/create.webp)

iv. Se generará el grant token. Asegúrate de copiarlo y almacenarlo de forma segura, ya que este es un proceso único y el token no se puede recuperar de la consola nuevamente.
[Aprende más sobre la generación de un grant token](https://docs.catalyst.zoho.com/es/api/oauth2/generate-grant-token/#GenerateGrantToken).
![generated-code](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/generated-code.webp)

v. Cambia a la pestaña **Client Secret** y toma nota de los detalles del client ID y client secret.
![client-secret](https://catalyst-docs-development.zohostratus.in/images/sdk/sdk-integration/client-secret.webp)

vi. Puedes generar el access token y refresh token usando la solicitud en [esta página de ayuda](https://docs.catalyst.zoho.com/es/api/oauth2/generate-access-and-refresh-token/#GenerateAccessandRefreshToken). También puedes actualizar el access token usando los pasos listados en [esta página](https://docs.catalyst.zoho.com/es/api/oauth2/refresh-access-token/#RefreshAccessToken).
Después de haber anotado todos los valores mencionados anteriormente, puedes configurarlos en el fragmento de código como se muestra a continuación e integrar el SDK de Python en tu aplicación. El código a continuación demuestra esto con el ejemplo de obtener buckets de [Catalyst CloudScale Stratus](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/introduction/).

### Fragmento de código

```python
import zcatalyst_sdk 
from zcatalyst_sdk import credentials 
from zcatalyst_sdk import types 
from zcatalyst_sdk.types import ICatalystOptions 
from flask import Flask, Request, make_response, jsonify 
from typing import Dict, Literal 
app = Flask(__name__) 
def list_all_buckets(): 
Cred = { 
        "refresh_token": "YOUR_REFRESH_TOKEN", //Ingresa aquí el token de actualización
        "client_id": "CLIENT_ID", //Ingresa aquí el ID de cliente
        "client_secret": "CLIENT_SECRET", //Ingresa aquí el secreto de cliente
    } 
project_id = PROJECT_ID //Ingresa aquí el ID del proyecto
project_key = ZAID //Ingresa aquí el ZAID
environment = "Development" //"Development" o "Production"
catalyst_credential = credentials.RefreshTokenCredential(Cred) 
catalyst_options = ICatalystOptions( 
project_id=project_id, 
project_key=project_key, 
project_domain="https://api.catalyst.zoho.com", 
environment=environment, 
) 
catalystApp = zcatalyst_sdk.initialize_app( 
credential=catalyst_credential, options=catalyst_options, 
name="TaskSDKPython" 
 ) 
stratus = catalystApp.stratus() 
buckets = stratus.list_buckets() 
print(buckets) 
return jsonify({"message": "Success", "bucket_data": buckets}) 
@app.route("/listbuckets", methods=["GET"]) 
def handle_list_all_buckets(): 
return list_all_buckets() 
if __name__ == "__main__": 
with app.app_context(): 
response = handle_list_all_buckets() 
port = 3006 
printf("Server running on http://localhost:{port}") 
app.run(port=port) 

```