Patrones de diseño de Amazon API Gateway - Criterios de selección entre REST API y HTTP API
Clarificamos los criterios de selección entre HTTP API y REST API, y presentamos patrones de autenticación con Cognito y Lambda Authorizer, así como métodos prácticos de diseño de throttling.
Criterios de selección entre REST API y HTTP API
API Gateway ofrece dos tipos: REST API y HTTP API. HTTP API es el tipo publicado en versión preliminar en diciembre de 2019 y con disponibilidad general desde marzo de 2020, que cubre las funciones principales de REST API con un precio hasta un 71% más económico y menor latencia. Si el uso principal es proxy hacia funciones Lambda o endpoints HTTP, se debe elegir HTTP API. Los casos en que se debe elegir REST API son: publicación de API para terceros con claves API y planes de uso, transformación de solicitudes/respuestas (plantillas de mapeo), integración con WAF, endpoints optimizados para edge, y cuando se necesita la función de validación de solicitudes. Para nuevos proyectos, se recomienda el enfoque de usar HTTP API como predeterminado y considerar REST API solo cuando se necesiten funciones que HTTP API no tiene.
Patrones de autenticación y autorización
API Gateway soporta múltiples métodos de autenticación, pero los tipos de autorizador disponibles difieren entre REST API y HTTP API (a fecha de agosto de 2026). El autorizador de Cognito User Pool (COGNITO_USER_POOLS) es un método exclusivo de REST API en el que API Gateway valida automáticamente los tokens JWT emitidos por Cognito. Como no es necesario implementar la lógica de validación de tokens por cuenta propia, resulta fácil de introducir en configuraciones que usan Cognito. HTTP API no dispone de este autorizador; en su lugar se utiliza el autorizador JWT. El autorizador JWT es un método que valida los JWT siguiendo el marco de OpenID Connect (OIDC) y OAuth 2.0, especificando el emisor (issuer) y la audiencia (audience). Dado que se puede indicar un Cognito User Pool como issuer, también es posible autenticar con Cognito en HTTP API, pero tenga en cuenta que el tipo de autorizador a configurar es distinto. El autorizador JWT verifica la firma con las claves públicas obtenidas del jwks_uri del issuer (solo se admiten algoritmos de la familia RSA) y evalúa claims como iss, aud y exp. Si se configuran ámbitos (scopes) de autorización por ruta, también es posible controlar el acceso según los scopes incluidos en el token. El Lambda Authorizer es un método que implementa lógica de autenticación personalizada en una función Lambda. Se utiliza cuando se necesita lógica de autorización flexible como formatos de token propios, integración con IdP externos o control basado en direcciones IP. Los resultados del Lambda Authorizer se pueden cachear, y configurando un TTL se reduce la ejecución duplicada de solicitudes de autenticación. La autenticación IAM es un método que autentica solicitudes con firma SigV4 de AWS, adecuado para comunicación interna entre servicios de AWS.
Throttling y planes de uso
El throttling de API Gateway se implementa con el algoritmo de token bucket. El límite predeterminado a nivel de cuenta es de 10,000 solicitudes/segundo por región, con un burst de 5,000 solicitudes. Se pueden configurar límites más granulares a nivel de stage y método, previniendo que un endpoint específico sobrecargue el backend. Los planes de uso son una función exclusiva de REST API que permite configurar límites de solicitudes diarios/mensuales y tasas de throttling por clave API. Al publicar API para socios externos, se pueden aplicar diferentes límites de tasa por socio. Se recomienda que los clientes que reciban respuestas 429 Too Many Requests implementen reintentos con backoff exponencial.
Precios de API Gateway
HTTP API cuesta aproximadamente 1.00 dólar por millón de solicitudes, un 71% más económico comparado con los 3.50 dólares de REST API (a fecha de agosto de 2026). WebSocket API cuesta aproximadamente 1.00 dólar por millón de mensajes más un cargo por tiempo de conexión (aproximadamente 0.25 dólares por millón de minutos). Al habilitar la caché de REST API, se genera un cargo por hora según el tamaño de la memoria caché (aproximadamente 0.02 dólares/hora para 0.5 GB). Configurar adecuadamente el TTL de caché del Lambda Authorizer para reducir el número de invocaciones Lambda de autenticación también es efectivo para la optimización de costos. La antigua capa gratuita de 12 meses (cuentas creadas antes del 15 de julio de 2025) incluía 1 millón de solicitudes/mes para HTTP API y REST API respectivamente; las cuentas creadas después de esa fecha usan el plan gratuito basado en créditos (hasta 200 dólares). Consulte el sitio oficial de AWS para las condiciones vigentes.
Resumen
API Gateway es un servicio que gestiona de forma centralizada la autenticación, el throttling y el monitoreo en la capa de API como punto de entrada de la arquitectura serverless. Teniendo el criterio de elegir HTTP API como opción predeterminada y seleccionar REST API cuando se necesiten funciones empresariales, se pueden optimizar los costos y la latencia.
Referencias (recursos oficiales de AWS)
Las fuentes primarias de esta página son el sitio web y la documentación oficiales de AWS. Consulta las páginas oficiales siguientes para conocer las especificaciones y los precios más recientes.
- Amazon API Gateway (página oficial)
- AWS Lambda (página oficial)
- Amazon Cognito (página oficial)
- Documentación de AWS (oficial)
Si esta página y la documentación oficial difieren, prevalece la documentación oficial.