# API Gateway -------------------------------------------------------------------------------- title: "Introducción" description: "Catalyst API Gateway te permite crear APIs para acceder a las Functions y endpoints del web client de tu aplicación, y realizar gestión avanzada de APIs." last_updated: "2026-07-30T07:10:05.682Z" source: "https://docs.catalyst.zoho.com/es/cloud-scale/help/api-gateway/introduction/" service: "Cloud Scale" -------------------------------------------------------------------------------- # API Gateway ### Introducción Un API Gateway es una capa intermedia entre el cliente y el servidor que actúa como un proxy inverso, enrutando las solicitudes del cliente a los servicios individuales. Catalyst Cloud Scale API Gateway es una herramienta avanzada de gestión de APIs que te permite crear, mantener y monitorear solicitudes HTTP generadas desde aplicaciones cliente y microservicios. Este componente está impulsado por Catalyst, ofreciendo fiabilidad, escalabilidad e integración fluida con otros componentes de Catalyst. Catalyst API Gateway actúa como un punto de entrada único para acceder a los siguientes componentes objetivo de tu aplicación Catalyst: * Basic I/O Functions * Advanced I/O Functions * Web Client Una vez que habilites API Gateway para tu proyecto Catalyst en la consola web de Catalyst, todas las solicitudes de los clientes para acceder a estos objetivos serán manejadas por este gateway. Esto ayuda a evitar que estos componentes queden expuestos directamente a los clientes al desacoplar los clientes de los servicios. Puedes crear APIs individuales personalizadas para cada tipo de solicitud para acceder a estos objetivos. El API Gateway maneja estas funcionalidades de una llamada a la API y procesa la solicitud en consecuencia: * Enrutamiento * Autenticación (opcional) * Limitación de velocidad (opcional) Catalyst proporciona API Gateway como un componente opcional de pago, y como una mejora a Security Rules. Mientras que Security Rules proporciona funcionalidades básicas de enrutamiento y autenticación para tus funciones, API Gateway ofrece más flexibilidad para personalizar las funcionalidades mencionadas anteriormente para tus APIs. Puedes obtener más información en la sección Security Rules vs API Gateway. También puedes trabajar con API Gateway desde el Catalyst CLI. Puedes habilitarlo o deshabilitarlo, y verificar su estado. Puedes aprender sobre esto en la página de ayuda de API Gateway en el CLI. También puedes descargar el archivo JSON que contiene las definiciones de las APIs que creas en tu consola remota a tu entorno local, y trabajar en él localmente. Luego puedes desplegarlo en la consola remota. <br /> -------------------------------------------------------------------------------- title: "Conceptos clave" description: "Catalyst API Gateway te permite crear APIs para acceder a las Functions y endpoints del web client de tu aplicación, y realizar gestión avanzada de APIs." last_updated: "2026-07-30T07:10:05.683Z" source: "https://docs.catalyst.zoho.com/es/cloud-scale/help/api-gateway/key-concepts/" service: "Cloud Scale" -------------------------------------------------------------------------------- # Conceptos clave Antes de aprender sobre la arquitectura e implementación de API Gateway, es importante comprender sus conceptos fundamentales en detalle. ### API Gateway vs Security Rules Catalyst API Gateway es una mejora de Catalyst Security Rules ya que proporciona funcionalidades adicionales para la gestión de APIs. Puntos a recordar: * Puedes habilitar o deshabilitar API Gateway en cualquier momento. * Cuando API Gateway está deshabilitado, se seguirán por defecto las configuraciones definidas para una función de Catalyst en Security Rules. * Cuando habilitas API Gateway para tu aplicación Catalyst, Security Rules se deshabilitará automáticamente. * Después de habilitar API Gateway, las URLs de tus funciones y web client se volverán inmediatamente inaccesibles hasta que crees APIs para ellas. Por lo tanto, si habilitas API Gateway, debes crear APIs para todas tus funciones y web client. * Puedes migrar las configuraciones de tus funciones en Security Rules a API Gateway usando auto-create. Las diferencias entre Security Rules y API Gateway se especifican a continuación: <table class="content-table"> <thead> <tr> <th><strong>Security Rules</strong></th> <th><strong>API Gateway</strong></th> </tr> </thead> <tbody> <tr> <td>Permite configurar el acceso para los métodos HTTP <strong><span class="badge">GET</span></strong>, <strong><span class="badge">PUT</span></strong>, <strong><span class="badge">POST</span></strong>, <strong><span class="badge">DELETE</span></strong> y <strong><span class="badge">PATCH</span></strong></td> <td>Permite configurar el acceso para los métodos HTTP <strong><span class="badge">GET</span></strong>, <strong><span class="badge">PUT</span></strong>, <strong><span class="badge">POST</span></strong>, <strong><span class="badge">DELETE</span></strong> y <strong><span class="badge">PATCH</span></strong>. También puede agregar todos los métodos HTTP bajo <a href="#routing">ANY</a>, y crear una sola API para ello.</td> </tr> <tr> <td>La URL de solicitud y la URL de destino son las mismas</td> <td>Permite configurar la URL de solicitud y la URL de destino por separado. Puede crear APIs individuales para cada método de solicitud para cada URL</td> </tr> <tr> <td>Permite habilitar o deshabilitar la autenticación y configurar dos tipos de autenticación: Catalyst Users Authentication y OAuth-based Authentication</td> <td>Permite habilitar o deshabilitar la autenticación y configurar <a href="#authentication-request-processor">tres tipos de autenticación</a>: API Key, Catalyst Users Authentication y OAuth-based Authentication</td> </tr> <tr> <td>Sin funcionalidad de limitación de velocidad</td> <td>Permite configurar <a href="#throttling">dos tipos de limitación de velocidad</a>: General Throttling e IP-based Throttling</td> </tr> <tr> <td>No permite configurar reglas para web clients</td> <td>Permite crear APIs para web clients</td> </tr> </tbody> </table> ### Enrutamiento El propósito principal de un API Gateway es enrutar al cliente hacia los servicios apropiados. Esto se define por dos aspectos de una API: la solicitud y el destino. Si no se ha configurado una API para un método de solicitud o URL de solicitud en particular, el cliente no podrá acceder al destino. Veamos estos conceptos en detalle. #### Métodos de solicitud Catalyst API Gateway admite los siguientes métodos de solicitud HTTP: * GET * PUT * POST * DELETE * PATCH También puedes agregar todos estos métodos HTTP bajo un método personalizado: ANY. Esto te permite crear una sola API para una función que admite los cinco métodos, en lugar de crear cinco APIs individuales, una para cada método. ANY se puede usar tanto en auto-create como en la creación de APIs personalizadas. Nota: Las APIs de web client no admiten ANY. Solo puedes seleccionar el método GET para un web client. #### URL de solicitud La URL de tu aplicación Catalyst tiene la siguiente estructura: https://_project\_domain\_name_.catalystserverless.com. Cuando creas una API, puedes definir la ruta de la solicitud y se agregará automáticamente a esta URL. Esta será la URL de solicitud. Por ejemplo, si la ruta de la solicitud es _/CustomerPortal/create_, se agregará a la URL de la aplicación de ese proyecto, y se creará la siguiente URL de solicitud: https://shipmenttracking-61317105.catalystserverless.com/CusomerPortal/create. Luego puedes proporcionar esta URL de solicitud intermediaria al cliente, en lugar de la URL predeterminada de la función de destino o del web client. La API enrutará automáticamente esta URL de solicitud al destino configurado. #### Destino y URL de destino Como se mencionó anteriormente, los componentes de destino de una API configurada en API Gateway pueden ser: Basic I/O functions, Advanced I/O functions, web client. Puedes establecer un destino para cada API que crees en API Gateway. Puedes crear múltiples APIs para cada destino para diferentes métodos de solicitud. Nota: API Gateway no maneja las solicitudes de los clientes para Cron Functions y Event Functions ya que no pueden ser ejecutadas directamente por los usuarios finales. El formato de URL de cada destino es el siguiente: * Basic I/O: https://_project\_domain\_name_.catalystserverless.com/baas/v1/ project/_project\_ID_/function/_function\_ID_/execute * Advanced I/O: https://_project\_domain\_name_.catalystserverless.com/server/_function\_name_/ * Web Client: https://_project\_domain\_name_.catalystserverless.com/app/ Puedes agregar rutas a la URL de destino de una función Advanced I/O o del web client y crear APIs para rutas específicas. #### Uso de expresiones regulares (Regex) en la URL de solicitud y la URL de destino Catalyst ofrece soporte para expresiones regulares para manejar valores dinámicos en la URL de solicitud. Una expresión regular (regex) es una secuencia de caracteres que describe un patrón de búsqueda. Cuando incluyes un patrón regex en la URL de solicitud, se ejecutan algoritmos de coincidencia de patrones y búsqueda y reemplazo cuando se proporciona el valor de entrada durante la ejecución y el patrón se reemplaza con el valor dinámico. Puedes ingresar un patrón regex en formato JSON en la URL de solicitud y pasar la clave a la URL de destino de la siguiente manera:<br /> Request url: /route/{path:\[0-9\]+}<br /> Target url: /route/{path} Por ejemplo, si el valor dinámico de una URL de solicitud contiene una cadena de números, puedes usar la expresión _\[0-9\]+_. Esto indica que los caracteres dentro de los corchetes en el valor dinámico pueden ser cualquier rango de números del 0 al 9 y el +\* indica una o más ocurrencias de los dígitos. Por lo tanto, la URL de solicitud aquí podría configurarse como: _/CustomerPortal/{portalID:\[0-9\]+}_. Ahora, si agregas una ruta a la URL de destino de una función Advanced I/O como: _/server/adIOFunc/CustomerPortal/{portalID}_, el ID proporcionado por el usuario en la URL de solicitud al acceder a ella se pasará dinámicamente a la función Advanced I/O de destino. También puedes usar un patrón comodín en tu expresión regular, como \., que indica que se puede aceptar cualquier número de caracteres literales o una cadena vacía en lugar del patrón comodín. Por ejemplo, si proporcionas un patrón comodín en la URL de solicitud como: /CustomerPortal/{path:(.\*)}, el usuario podrá ingresar cualquier valor dinámicamente en la URL como: _/CustomerPortal/johndoe12_, _/CustomerPortal/premiumUser/12809021_, o _/CustomerPortal/xae89013_. Si definiste un patrón regex en la URL para una función Advanced I/O en Security Rules, el mismo patrón se agregará tanto a la URL de solicitud como a la URL de destino durante auto-create. ### Procesador de solicitudes de autenticación El procesador de solicitudes maneja la autenticación de la API. La autenticación es una funcionalidad opcional en API Gateway. Si seleccionas No Authentication al crear la API, el destino será universalmente accesible para todos los clientes. Nota: La funcionalidad de autenticación no está disponible para las APIs de web client. Solo está disponible para las funciones Basic I/O y Advanced I/O. API Gateway admite tres métodos de autenticación. Puedes habilitar cualquiera de estos métodos o todos ellos. #### API Key Esta autenticación es manejada por una API key que Catalyst genera automáticamente para tu proyecto. La API Key es la misma para todos los proyectos en el entorno de desarrollo. Cuando despliegas un proyecto Catalyst al entorno de producción, Catalyst te proporcionará una API key diferente. Por lo tanto, tendrás API keys individuales para cada proyecto en el entorno de producción. Puedes obtener la API key después de crear una API para una función Basic I/O o Advanced I/O en tu proyecto, con la opción de autenticación API Key habilitada. Haz clic en View API Key en la sección de detalles de la API para acceder a la clave. Se abrirá una ventana emergente con la API key. Puedes pasar la API key de dos maneras: * Encabezado de solicitud<br /> Puedes pasar la API key como un encabezado en la URL de solicitud como se muestra en este ejemplo:<br /> curl -X POST \ https://shipmenttracking-61317105.catalystserverless.com/CustomerPortal/create \ -H "ZCFKEY: API_KEY" * Query String<br /> También puedes pasar la API key como un parámetro de consulta en la URL de solicitud como se muestra en este ejemplo: <br /> POST https://shipmenttracking-61317105.catalystserverless.com/CustomerPortal/ create?ZCFKEY=API_KEY Reemplaza API\_KEY con tu API key en ambos lugares. #### Catalyst Users Authentication Este método de autenticación habilita el acceso por defecto para todos los usuarios de tu aplicación Catalyst agregados en la sección _Users_ de Catalyst Authentication. Puedes manejar este método de autenticación incorporando un formulario de inicio de sesión de usuario en tu aplicación Catalyst y habilitando una sesión de inicio de sesión. Los usuarios de la aplicación podrán acceder al destino de la API automáticamente sin necesidad de pasar por ninguna verificación de usuario adicional. #### Autenticación basada en OAuth Este método de autenticación habilita el acceso para los usuarios con un token de acceso OAuth. Puedes pasar el token de acceso como un encabezado en la URL de solicitud como se muestra en este ejemplo: curl -X POST \ https://shipmenttracking-61317105.catalystserverless.com/CustomerPortal/create \ -H "Authorization: Zoho-oauthtoken Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57"" Para implementar la autenticación OAuth en tu aplicación Catalyst, consulta nuestra documentación de ayuda de autenticación OAuth para los pasos detallados. Nota: Al implementar protocolos OAuth para el acceso a API Gateway, debes tener en cuenta este comportamiento. Según tu tipo de usuario, se aplica lo siguiente: * **Usuarios autenticados** pueden acceder a tus funciones directamente sin ninguna configuración adicional. * **Tú y tus colaboradores**, además de proporcionar tu token OAuth, deben incluir el siguiente encabezado de solicitud para acceder a tus funciones: * **Clave:** ZC-OAUTH-USER * **Valor:** ADMIN ### Limitación de velocidad (Throttling) La limitación de velocidad te permite establecer un límite de tasa para controlar el uso de una API por parte de los clientes. La limitación de velocidad es una funcionalidad opcional en Catalyst API Gateway. Cuando estableces límites de tasa de limitación de velocidad para una API, Catalyst monitoreará el conteo de solicitudes realizadas a esa API. Cuando las solicitudes enviadas excedan los límites que has configurado para la API, API Gateway devolverá la respuesta de error HTTP: 429 Too Many Requests. Hay dos tipos de limitación de velocidad disponibles en API Gateway. Puedes usar uno o ambos métodos. #### Limitación de velocidad general La limitación de velocidad general define el máximo de solicitudes permitidas a la API para todos los usuarios, por unidad de tiempo. Puedes definir el límite de solicitudes, su tasa y la unidad de tiempo al crear la API. Catalyst implementa un algoritmo de limitación de tasa de ventana deslizante donde la ventana comienza desde el elemento actual y se desplaza por un valor ponderado de la tasa de solicitudes de la ventana anterior. Por ejemplo, si estableces 50 solicitudes en 2 minutos como límite, Catalyst verificará las solicitudes a la API en los 2 minutos anteriores al segundo actual y determinará el conteo, en lugar de verificar en una ventana fija de 2 minutos. #### Limitación de velocidad basada en IP La limitación de velocidad basada en IP define el número máximo de solicitudes permitidas a la API desde una dirección IP en particular, por unidad de tiempo. Esto limita el número de llamadas a la API que se pueden realizar desde una dirección de cliente en particular. Puedes definir el límite de solicitudes, su tasa y la unidad de tiempo de manera similar a la limitación de velocidad general. ### APIs auto-creadas, APIs personalizadas y la API predeterminada Puedes crear APIs para tus funciones de Catalyst y web client de dos maneras: auto-create o personalizada. Antes de hablar sobre las APIs auto-creadas y las APIs personalizadas, debes conocer la API predeterminada. #### La API predeterminada API Gateway crea una API predeterminada llamada Login Redirect para el web client alojado en tu proyecto Catalyst, además de la API regular del web client. Las siguientes reglas se aplican para la API Login Redirect: * Esta API se crea cuando creas APIs en API Gateway por primera vez después de alojar un web client en tu proyecto Catalyst, usando el método auto-create o el método personalizado. * La API Login Redirect se crea basándose en la configuración establecida en el archivo client-package.json para el web client. La URL configurada como login\_redirect en ese archivo se establecerá como la URL de solicitud y la URL de destino de la API. La clave login\_redirect es opcional. Por lo tanto, si no está configurada, la URL proporcionada como homepage se establecerá como la URL de solicitud y la URL de destino. * Si la URL configurada como login\_redirect comienza con '/', Catalyst la considerará como una ruta absoluta y la agregará directamente al dominio. Por ejemplo, si login\_redirect es '/home.html', la URL de solicitud tendrá el formato: https://_project\_domain\_name.catalystserverless_.com/home.html. Sin embargo, si el valor de login\_redirect no comienza con '/', como 'home.html', entonces la URL de solicitud tendrá el formato: https://_project\_domain\_name_.catalystserverless.com/app/home.html. * Los valores de limitación de velocidad general y limitación de velocidad basada en IP para esta API predeterminada se establecerán en Not configured, y el valor de autenticación se establecerá en No authentication. * Debes proporcionar la página predeterminada de redirección de inicio de sesión de la aplicación Catalyst como la URL de solicitud para la API Login Redirect. No debes proporcionar ninguna otra URL como su valor. * Si cambias el valor de login\_redirect en el archivo client-package.json después de que se creó la API Login Redirect, el valor de la URL de destino se cambiará automáticamente cuando despliegues el paquete del cliente en la consola de Catalyst. * No podrás editar ninguno de estos valores predeterminados excepto la URL de solicitud. No podrás modificar la URL de destino, el nombre de la API, la autenticación o los parámetros de limitación de velocidad. * No podrás eliminar la API Login Redirect. * La diferencia entre la API predeterminada Login Redirect y las APIs regulares del web client es que la Login Redirect API está destinada únicamente a la página predeterminada de redirección de inicio de sesión de la aplicación a la que los usuarios son redirigidos después de iniciar sesión. Sin embargo, puedes agregar rutas a la URL de destino de un web client y crear APIs para diferentes rutas para las APIs regulares del web client. * Si no has alojado un web client en tu proyecto Catalyst, esta API no se creará. #### APIs auto-creadas Puedes habilitar a Catalyst para crear automáticamente APIs para las funciones que elijas, o para el web client, usando el método auto-create. La creación automática de APIs solo está disponible hasta que crees tu primera API en API Gateway. Auto-create se puede usar cuando tienes un gran número de funciones configuradas en tu proyecto Catalyst, y crear APIs individuales para cada una de ellas sería muy lento. Cuando usas auto-create para crear APIs, se siguen estos protocolos: * Si has configurado definiciones para tus funciones en Security Rules, se migrarán a API Gateway automáticamente durante auto-create. Si no has configurado ninguna definición, se aplicarán las reglas predeterminadas. * Las APIs creadas para una función durante auto-create contendrán los métodos HTTP y la autenticación configurados en Security Rules. * Métodos de solicitud y URL:<br /> * Si los cinco métodos HTTP (GET, PUT, POST, DELETE, PATCH) están habilitados para una función en Security Rules, se creará automáticamente una sola API con el método de solicitud 'ANY' para la función. * Si uno o más de los cinco métodos HTTP está deshabilitado para una función en Security Rules, se crearán APIs individuales para cada uno de los otros métodos. * La URL de solicitud de una función será la misma que su URL de destino predeterminada o la URL de la función en auto-create, ya que la URL de solicitud y la URL de destino son las mismas en Security Rules. * Si hay un patrón regex en la URL de solicitud de una función, el mismo patrón se asignará a la URL de destino. * Autenticación:<br /> * Si el método de autenticación para una función en Security Rules es optional, el procesador de solicitudes se establecerá automáticamente en No Authentication para las APIs de la función durante auto-create. * Si la autenticación para una función en Security Rules está habilitada, Catalyst Users Authentication y OAuth-based Authentication se habilitarán automáticamente para las APIs de la función en API Gateway. * Limitación de velocidad: Los valores de limitación de velocidad general y limitación de velocidad basada en IP para las APIs de una función se establecerán en Not configured por defecto durante auto-create. * Nombre de la API: Una API creada usando auto-create para una función se nombrará en el formato: _FunctionName\_HTTPMethod_. Una API creada para un web client usando auto-create se nombrará en el formato: _WebclientName_. * API del web client: Los valores de limitación de velocidad general y limitación de velocidad basada en IP para un web client se establecerán en Not configured. Como se mencionó anteriormente, la autenticación no está disponible para las APIs del web client. La URL de solicitud de un web client también será la misma que su URL de la aplicación web de destino. * Límites estrictos: El límite estricto para el número de APIs que se pueden crear es 1000 APIs/proyecto. Después de que se creen las APIs para tus funciones y web client usando auto-create, puedes editar las APIs individuales y modificar los valores predeterminados según sea necesario. #### API personalizada Puedes crear una API personalizada para tu función o web client en cualquier momento y configurar los parámetros de la API. Puedes definir el método de solicitud y la URL, el destino, los métodos de autenticación, la limitación de velocidad y más según tus requisitos. La creación de una API personalizada no migra las configuraciones de una función desde Security Rules. -------------------------------------------------------------------------------- title: "Arquitectura" description: "Catalyst API Gateway te permite crear APIs para acceder a las Functions y endpoints del web client de tu aplicación, y realizar gestión avanzada de APIs." last_updated: "2026-07-30T07:10:05.690Z" source: "https://docs.catalyst.zoho.com/es/cloud-scale/help/api-gateway/architecture/" service: "Cloud Scale" -------------------------------------------------------------------------------- # Arquitectura La arquitectura de Catalyst API Gateway se muestra a continuación: <br /> Catalyst API Gateway realiza las tareas en la siguiente secuencia: 1. Lectura del método de solicitud y la URL de la solicitud del cliente 2. Búsqueda de una API que hayas configurado para el método de solicitud y la URL en particular 3. Inicio de la API, si está disponible, o denegación de la solicitud si la API no está disponible 4. Verificación de la configuración de limitación de velocidad y comprobación de si la solicitud está dentro de los límites de tasa definidos, si corresponde 5. Verificación de la configuración de autenticación e inicio de un manejador para verificar las credenciales, si corresponde 6. Habilitación de la API para redirigir al cliente a la URL de destino configurada, si todas las validaciones se superan <br /> -------------------------------------------------------------------------------- title: "Beneficios" description: "Catalyst API Gateway te permite crear APIs para acceder a las Functions y endpoints del web client de tu aplicación, y realizar gestión avanzada de APIs." last_updated: "2026-07-30T07:10:05.691Z" source: "https://docs.catalyst.zoho.com/es/cloud-scale/help/api-gateway/benefits/" service: "Cloud Scale" -------------------------------------------------------------------------------- ### Beneficios 1. Gestión eficiente de APIs<br /><br /> Catalyst API Gateway te permite gestionar todas tus APIs en un solo lugar. Proporciona un endpoint único para todos tus clientes, y te permite crear APIs personalizadas con definiciones flexibles para cada solicitud. La capacidad de agregar todos los métodos de solicitud HTTP compatibles en un solo método (ANY) aumenta la eficiencia y reduce los esfuerzos manuales en la creación y mantenimiento de un gran número de APIs. También minimiza la cantidad de viajes de ida y vuelta entre el cliente y el servidor de la aplicación, mejorando la experiencia del usuario final. 2. Seguridad mejorada para el backend de la aplicación<br /><br /> Catalyst API Gateway actúa como una capa intermedia entre el cliente y el servidor, y previene la comunicación directa entre ellos. Esto aísla la aplicación de los clientes y evita la exposición pública de su arquitectura backend y endpoints. API Gateway reduce el riesgo de amenazas potenciales asociadas con la exposición vulnerable al desacoplar completamente los clientes de los servicios. Los métodos de autenticación también actúan como refuerzos adicionales de seguridad, y garantizan la protección de la aplicación y los datos del usuario. 3. Descarga de funcionalidades de los servicios individuales<br /><br /> API Gateway descarga funcionalidades como la autenticación y la limitación de velocidad de los microservicios individuales, y maneja todo de manera consolidada. Esto reduce las responsabilidades de los servicios individuales, ya que no necesitan ser diseñados para gestionar la autenticación o la limitación de velocidad por sí mismos. API Gateway actúa como una unidad cohesiva para gestionar todas tus APIs de forma centralizada y optimiza la funcionalidad de tu aplicación. 4. Alto rendimiento a cualquier escala<br /><br /> Limitar la velocidad de una API mejora el rendimiento de la aplicación y proporciona una experiencia de usuario enriquecida. Ayuda a los sistemas backend a soportar picos de tráfico y previene el uso excesivo de recursos. La limitación de velocidad también asegura que un conjunto particular de clientes no monopolice los recursos del backend, y distribuye la eficiencia de la aplicación de manera uniforme entre todos los clientes. Puedes diseñar planes de uso en tu aplicación basados en los límites de velocidad que configures. Catalyst API Gateway garantiza que tu aplicación sea rápida, robusta, fiable y consistente. <br /> -------------------------------------------------------------------------------- title: "Implementación" description: "Catalyst API Gateway te permite crear APIs para acceder a las Functions y endpoints del web client de tu aplicación, y realizar gestión avanzada de APIs." last_updated: "2026-07-30T07:10:05.692Z" source: "https://docs.catalyst.zoho.com/es/cloud-scale/help/api-gateway/implementation/" service: "Cloud Scale" -------------------------------------------------------------------------------- # Implementación La sección de implementación es una guía de procedimientos paso a paso para configurar API Gateway desde la consola web de Catalyst. Puedes aprender sobre cómo trabajar con API Gateway desde el CLI en la documentación de ayuda del CLI. ### Habilitar API Gateway Debes habilitar API Gateway para tu proyecto antes de acceder a él por primera vez. Como se discutió anteriormente, cuando habilitas el API Gateway para tu aplicación Catalyst, las configuraciones en Security Rules se deshabilitan automáticamente. Las funciones y el web client alojados en tu proyecto Catalyst se volverán inmediatamente inaccesibles hasta que crees APIs para ellos. Por lo tanto, debes proceder con precaución. Asegúrate de crear APIs para todas tus funciones y web client inmediatamente después de habilitar API Gateway. También debes asegurarte de que los usuarios finales no accedan a ellos mientras tanto. Puedes aprender sobre cómo deshabilitar API Gateway en esta sección. Para habilitar API Gateway para tu aplicación Catalyst desde la consola: 1. Ve a API Gateway en _Security & Identity_ en la consola de Catalyst Cloud Scale y haz clic en Enable Now. <br /> 2. Haz clic en Proceed en la ventana de confirmación.<br /> <br /> Recibirás una notificación en la consola una vez que API Gateway esté habilitado para tu proyecto Catalyst. <br> ### Crear una API Antes de comenzar, debes asegurarte de haber alojado al menos una función o el web client en tu proyecto Catalyst, para crear una API para ello. Nota: Puedes crear hasta 1000 APIs en un proyecto en el entorno de desarrollo. No hay límites superiores para la creación de reglas en el entorno de producción. <br> #### Auto-Create Solo puedes usar auto-create para crear APIs automáticamente cuando habilitas API Gateway para tu proyecto por primera vez. Si ya has creado una API personalizada, no podrás acceder a auto-create. Consulta esta sección para los protocolos a seguir al migrar definiciones desde Security Rules. Para crear APIs para tus funciones o el web client usando auto-create: 1. Haz clic en Create API después de habilitar API Gateway en la consola de Catalyst.<br /> <br /> 2. Selecciona Auto-create API y haz clic en Next.<br /> <br /> 3. Todas tus funciones Basic I/O y Advanced I/O, y el web client están seleccionados por defecto.<br /> <br /> Deselecciona los servicios para los que no quieras crear APIs y haz clic en Create.<br /> <br /> Catalyst iniciará el proceso de creación de APIs.<br /> <br /> Una vez que se creen las APIs, recibirás una notificación en tu consola. Las APIs se listarán en la página de _API Gateway_. <br /> Puedes editar los valores predeterminados establecidos para estas APIs, y configurarlas individualmente según tus requisitos. Como se discutió en esta sección, la API predeterminada Login Redirect API también se crea para el web client alojado en el proyecto. <br> #### Crear una API personalizada Puedes crear una API personalizada inmediatamente después de habilitar API Gateway o en cualquier momento después de usar auto-create. Para crear una API personalizada para tus funciones o el web client: 1. Haz clic en Create API desde la página de _API Gateway_.<br /> <br /> También puedes crearla seleccionando Create a custom API en el cuadro emergente después de habilitar API Gateway y haciendo clic en Next.<br /> <br /> Esto abrirá la ventana de _Create API_.<br /> <br /> 2. Ingresa un nombre único para la API. Selecciona un método de solicitud e ingresa la URL de solicitud.<br /> <br /> Notas:<br /> * Solo puedes seleccionar el método GET para un web client. <br> * La combinación de la URL de solicitud y el método de solicitud debe ser única. No podrás crear más de una API para una combinación específica de URL de solicitud y método de solicitud. Selecciona el componente de destino y luego selecciona la función o el web client específico.<br /> <br /> Si seleccionaste una función Advanced I/O o un web client, puedes agregar una ruta a la URL de destino predeterminada. También se mostrará una vista previa de la URL de solicitud.<br /> <br /> Selecciona los métodos de autenticación si necesitas autenticación. Puedes seleccionar uno o todos estos métodos, e implementar cualquiera de ellos al proporcionar la URL de solicitud.<br /> <br /> Configura los límites de velocidad para la API. Puedes configurar uno o ambos métodos de limitación de velocidad.<br /> <br /> 3. Haz clic en Create. La API se creará y se listará en la página de _API Gateway_. <br> ### Editar una API Puedes editar una API auto-creada o personalizada en cualquier momento y modificar sus definiciones de la siguiente manera: 1. Haz clic en Edit para la API.<br /> <br /> 2. Modifica los valores requeridos y haz clic en Update.<br /> <br> ### Eliminar una API Puedes eliminar una API de la siguiente manera: 1. Haz clic en Delete para la API.<br /> <br /> 2. Haz clic en Yes, Proceed en el cuadro de confirmación.<br /> <br /> Nota: Eliminar una API hará que la URL de destino asociada sea inaccesible. <br> ### Deshabilitar API Gateway Puedes deshabilitar API Gateway en cualquier momento y cambiar a las definiciones configuradas en Security Rules. Si vuelves a habilitar API Gateway después de deshabilitarlo, todas las APIs que hayas creado seguirán disponibles y se rehabilitarán inmediatamente cuando API Gateway se vuelva a habilitar. No tendrás que crear las mismas APIs de nuevo. Para deshabilitar API Gateway: 1. Haz clic en el ícono de puntos suspensivos en la página de _API Gateway_ y haz clic en Disable.<br /> <br /> 2. Escribe "DISABLE" en el cuadro de texto y haz clic en Confirm.<br /> El API Gateway se deshabilitará y Security Rules se habilitará automáticamente de inmediato. <br />