AWS API Gateway

¿Qué es?

AWS API Gateway es un servicio completamente administrado que facilita la creación, publicación y gestión de APIs a cualquier escala. Actúa como la puerta de entrada entre aplicaciones cliente y servicios backend, manejando automáticamente tareas críticas como autenticación, autorización, throttling, caching y monitoreo.

El servicio elimina la complejidad operacional de construir y mantener tu propia infraestructura de API. Con integración nativa a AWS Lambda, permite crear arquitecturas serverless completas donde el código se ejecuta solo cuando es necesario, sin gestionar servidores.

API Gateway soporta tres tipos de API: REST APIs para servicios web tradicionales con features completas, HTTP APIs para casos de uso simples con menor latencia y costo, y WebSocket APIs para comunicación bidireccional en tiempo real.

Comparación HTTP API vs REST API

Ejemplo de código: Terraform

# API Gateway HTTP API con Lambda
resource "aws_apigatewayv2_api" "main" {
  name          = "user-api"
  protocol_type = "HTTP"
  
  cors_configuration {
    allow_credentials = false
    allow_headers     = ["content-type", "x-amz-date", "authorization"]
    allow_methods     = ["GET", "POST", "PUT", "DELETE"]
    allow_origins     = ["https://app.example.com"]
    max_age          = 86400
  }
}
 
resource "aws_apigatewayv2_integration" "lambda" {
  api_id           = aws_apigatewayv2_api.main.id
  integration_type = "AWS_PROXY"
  
  connection_type      = "INTERNET"
  description         = "Lambda proxy integration"
  integration_method  = "POST"
  integration_uri     = aws_lambda_function.user_handler.invoke_arn
  passthrough_behavior = "WHEN_NO_MATCH"
}
 
resource "aws_apigatewayv2_route" "users" {
  api_id    = aws_apigatewayv2_api.main.id
  route_key = "GET /users/{id}"
  target    = "integrations/${aws_apigatewayv2_integration.lambda.id}"
  
  authorization_type = "JWT"
  authorizer_id     = aws_apigatewayv2_authorizer.jwt.id
}
 
resource "aws_apigatewayv2_stage" "prod" {
  api_id      = aws_apigatewayv2_api.main.id
  name        = "prod"
  auto_deploy = true
  
  default_route_settings {
    throttling_rate_limit  = 1000
    throttling_burst_limit = 2000
  }
}

Patrones de integración

API Gateway soporta múltiples patrones de integración según las necesidades arquitectónicas:

Lambda Proxy Integration: El patrón más común para arquitecturas serverless. API Gateway envía todo el request HTTP como evento JSON a Lambda, que debe devolver una respuesta HTTP estructurada. Ideal para lógica de negocio compleja.

VPC Link a Application Load Balancer: Para integrar con servicios corriendo en AWS ECS o EC2 dentro de una VPC privada. API Gateway se conecta a través de un VPC Link a un ALB interno, permitiendo arquitecturas híbridas.

HTTP Proxy: Reenvía requests directamente a endpoints HTTP externos con transformaciones mínimas. Útil para agregar autenticación o throttling a APIs existentes.

Mock Integrations: Respuestas estáticas configuradas directamente en API Gateway, útiles para testing, documentación interactiva o endpoints de health check.

Opciones de autorización

Decisión: Usa IAM para APIs internas, Cognito para aplicaciones con usuarios finales, JWT para integración con proveedores externos, y Lambda Authorizer solo cuando necesites lógica de autorización compleja.

Observabilidad

API Gateway proporciona observabilidad completa a través de múltiples servicios AWS:

CloudWatch Metrics: Métricas automáticas como latencia, error rate, y request count por stage y método. Incluye métricas de throttling y autorización fallida para debugging.

X-Ray Tracing: Tracing distribuido que muestra el flujo completo desde API Gateway hasta Lambda y otros servicios AWS. Esencial para identificar cuellos de botella en arquitecturas complejas.

Access Logging: Logs detallados de cada request con información como IP del cliente, user agent, latencia, y response code. Se pueden enviar a CloudWatch Logs o S3 para análisis posterior.

Configuración de dominio personalizado

resource "aws_apigatewayv2_domain_name" "api" {
  domain_name = "api.example.com"
  
  domain_name_configuration {
    certificate_arn = aws_acm_certificate.api.arn
    endpoint_type   = "REGIONAL"
    security_policy = "TLS_1_2"
  }
}
 
resource "aws_apigatewayv2_api_mapping" "main" {
  api_id      = aws_apigatewayv2_api.main.id
  domain_name = aws_apigatewayv2_domain_name.api.id
  stage       = aws_apigatewayv2_stage.prod.name
}

Throttling y quotas

API Gateway implementa throttling a múltiples niveles: account-level (10,000 RPS por región por defecto), stage-level, y method-level. Los límites se pueden configurar independientemente, y el servicio devuelve HTTP 429 cuando se exceden.

Para aplicaciones con tráfico variable, considera configurar burst limits que permiten picos temporales. Usage Plans permiten crear diferentes niveles de servicio con quotas diarias/mensuales para diferentes tipos de clientes.

¿Por qué importa?

API Gateway elimina meses de desarrollo de infraestructura que típicamente requiere construir una capa de entrada HTTP robusta. Con features como autorización integrada, throttling automático, y observabilidad nativa, permite que equipos de ingeniería se enfoquen en lógica de negocio en lugar de plumbing.

La diferencia de precio entre HTTP API ($1/millón) y REST API ($3.50/millón) puede ser significativa a escala, pero REST API ofrece features como caching y transformaciones que pueden reducir costos downstream. La decisión correcta depende del volumen de tráfico y complejidad de transformaciones requeridas.

Referencias

• AWS API Gateway Documentation — AWS, 2024. Documentación oficial completa.
• HTTP API vs REST API Comparison — AWS, 2024. Comparación detallada entre tipos de API.
• API Gateway Pricing — AWS, 2024. Modelo de precios actualizado.
• API Gateway Quotas and Limits — AWS, 2024. Límites de servicio y quotas.
• Best Practices for REST APIs — AWS, 2024. Guía de mejores prácticas.
• API Gateway Performance Tuning — AWS Compute Blog, 2023. Optimización de rendimiento y costos.