Integraciones: Lambda, HTTP y Mock

Cada método de API Gateway necesita una integración de backend: el sistema que procesa la solicitud y devuelve una respuesta. API Gateway admite cinco tipos de integración: Lambda Proxy, Lambda Custom, HTTP Proxy, HTTP Custom y Mock. HTTP APIs solo admiten Lambda Proxy y HTTP Proxy. REST APIs admiten los cinco. Elegir la integración adecuada determina cuánto control tiene sobre la transformación de la solicitud y la respuesta.

Con la integración Lambda Proxy, API Gateway transmite la solicitud HTTP completa a Lambda como un objeto de evento estructurado que incluye encabezados, cadenas de consulta, parámetros de ruta, cuerpo y contexto. Su función de Lambda debe devolver un objeto de respuesta con el formato correcto, que incluya statusCode, headers y body. Este es el patrón más sencillo y habitual: no requiere plantillas de mapeo y Lambda controla toda la respuesta.

Con la integración Lambda Non-Proxy (personalizada), API Gateway utiliza plantillas de mapeo (Apache Velocity Template Language, VTL) para transformar la solicitud antes de enviarla a Lambda y transforma la respuesta de Lambda antes de devolverla al cliente. Su función de Lambda recibe un payload personalizado y limpio, no el evento sin procesar de API Gateway. Esto separa las cuestiones de transporte de la lógica de negocio, pero requiere mantener las plantillas VTL. Utilice la integración personalizada cuando desee separar estrictamente el contrato entre la API y el backend.

La integración HTTP Proxy reenvía las solicitudes directamente a un endpoint HTTP externo (que puede ser una instancia de EC2, un ALB, un servidor local o cualquier URL pública) sin transformarlas. API Gateway transmite la solicitud y devuelve al cliente la respuesta del backend. Es ideal para migrar backends REST existentes detrás de API Gateway y añadir limitación de velocidad, supervisión y claves de API sin cambiar el código del backend. Admite backends HTTPS con verificación de certificados.

La integración HTTP Custom también reenvía las solicitudes a un endpoint HTTP externo, pero utiliza plantillas de mapeo para transformar tanto la solicitud que se envía al backend como la respuesta que se recibe. Resulta útil cuando la interfaz de API Gateway y la API de backend tienen contratos diferentes: puede traducir una llamada a una API REST a un formato SOAP heredado o personalizado, y transformar la respuesta del backend en una estructura JSON limpia para el cliente. Esto añade complejidad, pero proporciona el máximo control para las integraciones con sistemas heredados.

La integración con AWS Service conecta API Gateway directamente con los servicios de AWS sin un intermediario de Lambda. Por ejemplo, puede configurar un endpoint POST que escriba directamente un mensaje en SQS, lo publique en SNS o inicie una ejecución de Step Functions. Esto reduce la latencia y elimina los costes de las funciones de Lambda para operaciones de enrutamiento sencillas. La integración requiere configurar un rol de IAM y plantillas de mapeo para dar el formato correcto a la llamada a la API de AWS.

La integración simulada configura API Gateway para devolver una respuesta predefinida sin llamar a ningún backend. La respuesta se define en la plantilla de asignación de la respuesta de integración. Las integraciones simuladas son ideales para: desarrollar la API antes de crear el backend (los equipos de frontend pueden empezar de inmediato), probar unitariamente las configuraciones de la API, devolver encabezados CORS estándar o proporcionar un stub para socios externos durante el desarrollo. Los endpoints simulados también pueden utilizarse para bloquear versiones obsoletas de una API devolviendo 410 Gone.

CORS (Cross-Origin Resource Sharing) debe habilitarse cuando un cliente de navegador ubicado en un dominio llama a su API ubicada en otro dominio. HTTP API ofrece una configuración de CORS con un solo clic; REST API requiere crear un método OPTIONS con una integración simulada que devuelva los encabezados CORS necesarios (Access-Control-Allow-Origin, Access-Control-Allow-Methods, Access-Control-Allow-Headers). La integración de proxy de Lambda también requiere que Lambda devuelva encabezados CORS en su respuesta.

REST API admite la validación de solicitudes: API Gateway puede validar que los parámetros obligatorios de la cadena de consulta, los encabezados y el esquema del cuerpo de la solicitud estén presentes y tengan el formato correcto, antes de invocar el backend. Esto reduce las invocaciones innecesarias de Lambda causadas por solicitudes mal formadas y devuelve automáticamente errores 400 estandarizados. Defina un modelo de solicitud mediante JSON Schema y asígnelo al método para habilitar la validación del cuerpo. La validación de solicitudes no está disponible en HTTP API.

API Gateway tiene un tiempo de espera de integración predeterminado de 29 segundos para REST API y HTTP API (el máximo para REST API y fijo para el proxy de HTTP API). Si el backend tarda más de 29 segundos, API Gateway devuelve un error 504 Gateway Timeout. Esto significa que las funciones de Lambda invocadas sincrónicamente mediante API Gateway deben completarse en 29 segundos, aunque Lambda admita tiempos de espera de hasta 15 minutos. Para operaciones de larga duración, utilice un patrón asíncrono: API Gateway activa Lambda, que inicia un trabajo asíncrono y devuelve inmediatamente un ID de trabajo.

Guía para elegir el tipo de integración: Lambda Proxy: la opción más común y sencilla, con control total de la solicitud en Lambda; Lambda Custom: cuando necesita transformar la solicitud o la respuesta en la capa de gateway; HTTP Proxy: para backends HTTP existentes y escenarios de migración; HTTP Custom: para traducir formatos de API heredados; AWS Service: para eliminar Lambda en el enrutamiento sencillo a SQS/SNS/DynamoDB; Mock: para stubs de desarrollo y solicitudes de comprobación previa de CORS. En el examen SAA-C03, los patrones Lambda Proxy y HTTP Proxy son los que se evalúan con mayor frecuencia.

Compruebe su comprensión de los conceptos de AWS Solutions Architect (SAA-C03) de esta lección.

En esta lección ha aprendido lo siguiente: la integración Lambda Proxy pasa la solicitud completa a Lambda, que controla la respuesta; es la integración más sencilla y común. HTTP Proxy reenvía las solicitudes a backends HTTP existentes para añadir funciones de API Gateway sin modificar el backend. La integración simulada devuelve respuestas predefinidas para el desarrollo y las pruebas del frontend sin ninguna infraestructura de backend. A continuación, exploraremos la autorización de API Gateway con IAM, los autorizadores de Lambda y Cognito.