AWS Primeros Pasos
Redes

Amazon API Gateway

Servicio totalmente gestionado para crear, publicar y administrar REST API, HTTP API y WebSocket API, funcionando como puerta de entrada a Lambda y otros servicios AWS

Unos 5 min de lectura

Descripción general

Amazon API Gateway es un servicio totalmente gestionado para crear, publicar, mantener, monitorear y proteger APIs a cualquier escala. Soporta tres tipos: REST API, HTTP API y WebSocket API, pudiendo conectar funciones Lambda, instancias EC2 y cualquier endpoint HTTP como backend. Proporciona de forma integral funcionalidades necesarias para la gestión de APIs: gestión de claves API, planes de uso, throttling, transformación de solicitudes/respuestas, autenticación/autorización con Cognito o IAM, y configuración de nombres de dominio personalizados. HTTP API es más económica por solicitud y de menor latencia que REST API, siendo adecuada para proxies API simples. WebSocket API soporta comunicación bidireccional en tiempo real, útil para construir aplicaciones de chat y dashboards en vivo.

Criterios de selección entre REST API y HTTP API

API Gateway ofrece dos tipos de API basadas en HTTP: REST API y HTTP API, que se seleccionan según los requisitos. REST API cuenta con funcionalidades avanzadas como transformación de solicitudes/respuestas (mapping templates), control de acceso mediante claves API y planes de uso, validación de solicitudes, caché, integración con WAF y canary releases. Es adecuada para APIs empresariales o cuando se requieren transformaciones complejas de solicitudes. HTTP API omite algunas de estas funcionalidades avanzadas a cambio de un precio por solicitud inferior al de REST API y menor latencia. Como los precios unitarios varían según la región y el tramo de uso, conviene consultarlos en la página de precios de AWS. Soporta nativamente autorizadores JWT, configuración automática de CORS e integración con OpenID Connect/OAuth 2.0, ofreciendo funcionalidad suficiente como proxy simple hacia Lambda o backends HTTP. Mientras que Azure API Management es una plataforma integral que incluye portal de desarrolladores y gestión del ciclo de vida de APIs, API Gateway se especializa en la integración con Lambda como entrada a arquitecturas serverless, con una facturación basada principalmente en el número de solicitudes.

Diseño de autenticación/autorización y throttling

La autenticación/autorización de API Gateway varía según el tipo de API. REST API permite elegir entre tres mecanismos: autorizador Cognito, autorizador Lambda (basado en token/basado en solicitud) y autenticación IAM. HTTP API soporta nativamente autorizadores JWT, pudiendo validar directamente tokens de proveedores OIDC como Cognito o Auth0, eliminando la necesidad de escribir un autorizador Lambda. La configuración de throttling puede establecerse tanto a nivel de cuenta como a nivel de stage y método, previniendo la sobrecarga del backend. A septiembre de 2026, la cuota predeterminada por cuenta es de 10.000 solicitudes por segundo por región (con una capacidad máxima de ráfaga de 5.000 solicitudes); algunas regiones tienen valores predeterminados menores. El valor predeterminado de RPS puede aumentarse mediante solicitud, mientras que la capacidad de ráfaga se deriva de la cuota de RPS y no puede solicitarse por separado. Combinando planes de uso con claves API, se pueden establecer límites de solicitudes por socio externo y monitorear el uso de la API.

Gestión de stages y canary releases

La función de stages de API Gateway es un mecanismo para operar múltiples versiones de la misma API en paralelo. Utilizando variables de stage, se pueden especificar diferentes funciones Lambda o URLs de backend para cada entorno dev/staging/prod, completando la promoción entre entornos simplemente cambiando el deployment. REST API permite canary releases, donde se aumenta gradualmente el tráfico hacia la nueva versión desde un 10%, monitoreando la tasa de errores y latencia con métricas de CloudWatch, con posibilidad de rollback inmediato si hay problemas. Combinando nombres de dominio personalizados con certificados ACM, se pueden proporcionar endpoints API con marca como api.example.com, y también es posible consolidar múltiples APIs en un solo dominio mediante base path mapping.

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.

Si esta página y la documentación oficial difieren, prevalece la documentación oficial.

Compartir

Términos relacionados

AWS LambdaAmazon CognitoAWS Step FunctionsAWS WAF

Servicios relacionados

AWS LambdaAmazon CognitoAWS WAF

Artículos relacionados

Patrones de diseño de Amazon API Gateway - Criterios de selección entre REST API y HTTP APIClarificamos 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.Integración de GraphQL de microservicios con AWS AppSync Merged API - Práctica de desarrollo distribuido por equiposIntegra APIs GraphQL desarrolladas y desplegadas independientemente por múltiples equipos en un único endpoint. Presenta estrategias para evitar conflictos de esquema y diseño de autenticación.Autenticación de usuarios con Amazon Cognito - Diseño de User Pool e Identity PoolExplicamos la autenticación de usuarios con Cognito User Pool, el acceso a recursos AWS con Identity Pool y la integración de inicio de sesión social.Desarrollo de aplicaciones web full-stack con AWS Amplify - Despliegue con integración Git y construcción de backendConstruya entornos de despliegue automático por rama con integración GitHub, y defina autenticación, API y almacenamiento en TypeScript con Backend Gen 2. También compatible con SSR de Next.js.Diseño visual de aplicaciones serverless con AWS Infrastructure Composer (antes AWS Application Composer) - Generación automática de plantillas IaCExplica el diseño visual de arquitecturas serverless con Infrastructure Composer, la generación automática de plantillas SAM y la integración con VS Code.

Términos y artículos similares

Construcción de APIs serverless - Infraestructura API escalable con Amazon API GatewayExplicamos cómo construir APIs serverless utilizando Amazon API Gateway y Lambda.Patrones de diseño de Amazon API Gateway - Criterios de selección entre REST API y HTTP APIClarificamos 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.Amazon API GatewayUn servicio completamente administrado para crear, publicar, gestionar y monitorear APIs¿Por qué las API de AWS devuelven XML? - La historia de la evolución desde Query API hasta REST JSONExplicamos las razones históricas por las que las API de S3 y EC2 devuelven respuestas XML, las diferencias entre Query API y REST API, la evolución de la autenticación de Signature V2 a V4, y la complejidad que los SDK ocultan.Integración de GraphQL de microservicios con AWS AppSync Merged API - Práctica de desarrollo distribuido por equiposIntegra APIs GraphQL desarrolladas y desplegadas independientemente por múltiples equipos en un único endpoint. Presenta estrategias para evitar conflictos de esquema y diseño de autenticación.