Desarrollo de APIs

Desarrollo de aplicaciones en AWS

Ricardo Sueiras

Principal Technologist

Integraciones de API Gateway

 

• Varias opciones de integración de back-end
• HTTP: cualquier endpoint público enrutable
• APIs de servicios de AWS como DynamoDB o SNS
• Funciones Lambda
• Recursos privados vía enlaces VPC
• Respuestas simuladas sin back-end real

Tipos de integración: proxy

 

• El tipo de integración define cuánto controla API Gateway
• Tipos proxy: AWS_PROXY y HTTP_PROXY
• Se envía toda la solicitud HTTP directamente al back-end
• API Gateway actúa como un paso transparente
• El back-end construye la respuesta

Tipos de integración: no proxy

• Tipos no proxy: AWS y HTTP
• Tú configuras transformaciones de solicitud y respuesta
• Impulsadas por plantillas de mapeo
• Plantillas en Velocity Template Language (VTL)

 

Validación de solicitudes

 

• Valida solicitudes antes de llegar al back-end
• Detecta campos obligatorios ausentes
• Detecta formato JSON no válido
• Detecta tipos de parámetros incorrectos
• Suele devolver 400 Bad Request en fallos

Validación de solicitudes

 

• La validación puede abarcar:
  • Cabeceras
  • Parámetros de cadena de consulta
  • Cuerpo de la solicitud
  • Esquema JSON

Validación de solicitudes

 

• La validación aporta:
  • Menos solicitudes inválidas al back-end
  • Menor coste de ejecución de Lambda
  • Mayor fiabilidad de la API

Transformaciones

• Reformatea solicitudes y respuestas sin tocar el back-end
  • Cambiar la estructura del payload
  • Renombrar campos
  • Transformar cabeceras
  • Convertir formatos de datos
  • Ocultar detalles de implementación
• Basado en plantillas de mapeo VTL

 

Gestión de errores

 

• Dos categorías de error
  • Errores del gateway: generados por API Gateway
  • Errores de integración: fallos del back-end
• Errores de gateway comunes:
  • 400 Bad Request: validación de solicitud fallida
  • 429 Too Many Requests: límite de throttling superado

Gestión de errores

 

• Errores de integración comunes:
  • 502 Bad Gateway: respuesta malformada o errónea
  • 503 Service Unavailable: back-end no disponible o saturado
  • 504 Gateway Timeout: superado el tiempo de espera de 29 s
  • Las REST APIs Regional y Private pueden superar 29 s

Registro

• Los registros de ejecución y métricas de CloudWatch son clave para depurar
• API Gateway se integra con CloudWatch para:
  • Registros
  • Métricas
  • Trazas de ejecución

 

 

Registro

• Los registros de CloudWatch ayudan a diagnosticar:
  • Integraciones fallidas
  • Errores de transformación
  • Fallos de autorización
  • Problemas de ejecución de Lambda

 

 

Fases: gestión entre entornos

 

• Una definición de API sirve a varios entornos
• Las fases son cómo API Gateway gestiona esos entornos

Fases: gestión entre entornos

 

• Una definición de API sirve a varios entornos
• Las fases son cómo API Gateway gestiona esos entornos
• Una fase es una referencia con nombre
• Apunta a una instantánea de despliegue de tu configuración de API

Fases: gestión entre entornos

 

• Una definición de API sirve a varios entornos
• Las fases son cómo API Gateway gestiona esos entornos
• Una fase es una referencia con nombre
• Apunta a una instantánea de despliegue de tu configuración de API
• Nombres de fase habituales:
  • Dev
  • Test
  • QA y Prod

Fases: gestión entre entornos

 

• Una definición de API sirve a varios entornos
• Las fases son cómo API Gateway gestiona esos entornos
• Una fase es una referencia con nombre
• Apunta a una instantánea de despliegue de tu configuración de API
• Nombres de fase habituales: Dev, Test, QA, Prod
• La invoke URL refleja cada fase

Fases: gestión entre entornos

 

• Una definición de API sirve a varios entornos
• Las fases son cómo API Gateway gestiona esos entornos
• Una fase es una referencia con nombre
• Apunta a una instantánea de despliegue de tu configuración de API
• Nombres de fase habituales: Dev, Test, QA, Prod
• La invoke URL refleja cada fase
• Varias fases pueden apuntar a un despliegue para rollback instantáneo

Fases: gestión entre entornos

 

• Los cambios solo entran en vigor al desplegarse en una fase

Capacidades de las fases

• Cada fase se configura de forma independiente
• La configuración incluye variables de fase
• Las variables de fase son pares clave-valor
• Dirige un despliegue a distintos back-ends
• Sin redespiegues para cambios de entorno

 

Capacidades de las fases

• Despliegues canario
  • Solo REST APIs
  • Envía un porcentaje del tráfico a un nuevo despliegue
  • Promoción a lanzamiento completo
  • Borra el canario para revertir

 

Capacidades de las fases

• Throttling
  • Se configura a nivel de fase
  • Se aplica a todos los métodos, con excepciones por método

 

Capacidades de las fases

• Throttling
  • Se configura a nivel de fase
  • Se aplica a todos los métodos, con excepciones por método
• Caché
  • Solo REST APIs
  • Almacena respuestas del back-end en la fase
  • Los clientes lo omiten con Cache-Control
  • TTL de 0 a 3600 s, por defecto 300

 

Capacidades de las fases

• El registro ofrece dos modos
  • Registros de acceso
  • Construidos con variables $context, enviados a un grupo de logs de CloudWatch
  • Registros de ejecución
  • Capturan el detalle completo de solicitud y respuesta

 

¡Vamos a practicar!

Desarrollo de aplicaciones en AWS