Curso de API REST

Clase 1 • URLs, URIs y nomenclatura de recursos

Explica la estructura de las URIs y cómo se direccionan los recursos en REST. Una nomenclatura correcta impacta directamente en la usabilidad y descubribilidad de la API.

Clase 2 • Fundamentos del protocolo HTTP

Cubre el ciclo de solicitud-respuesta HTTP, los encabezados y los códigos de estado. Brinda la base del protocolo en la que se apoya toda API REST.

Clase 3 • Qué es una API REST

Define REST como un estilo arquitectónico y lo contrasta con RPC y SOAP. Establece el vocabulario que se usa a lo largo del curso.

Clase 4 • Las seis restricciones arquitectónicas de REST

Examina cada restricción de Fielding y su implicancia práctica. Comprender las restricciones guía las decisiones de diseño de APIs conformes.

Clase 1 • Estrategias de versionado de APIs

Compara los enfoques de versionado por URI, encabezado y tipo de medio. Elegir la estrategia correcta evita cambios disruptivos para los clientes existentes.

Clase 2 • Diseño de carga útil de solicitudes y respuestas

Define la estructura de la carga útil, la nomenclatura de campos y las convenciones de envoltura. Las cargas útiles bien diseñadas reducen los errores de integración para los consumidores.

Clase 3 • Diseño de subrecursos y relaciones

Modela las relaciones entre recursos usando enfoques anidados y enlazados. La elección del patrón adecuado afecta el rendimiento y la claridad.

Clase 4 • Fundamentos del modelado de recursos

Identifica las entidades del dominio y las mapea a recursos REST. Un modelado adecuado evita la proliferación descontrolada de endpoints y la inconsistencia.

Clase 1 • Estructura y sintaxis JSON

Repasa los tipos de datos JSON, el anidado y las trampas comunes. JSON es el formato de carga útil dominante en REST y debe manejarse con precisión.

Clase 2 • Negociación de contenido

Explica los encabezados Accept y Content-Type para la negociación de formato. Permite que las APIs sirvan múltiples formatos desde un único endpoint.

Clase 3 • Manejo de datos binarios y archivos

Cubre las cargas multipart, la codificación Base64 y los patrones de descarga de archivos. El manejo de binarios es esencial para las APIs de medios y documentos.

Clase 4 • Definición y validación de esquemas

Usa JSON Schema para definir y validar las cargas útiles de solicitudes y respuestas. La validación de esquemas detecta errores antes de que lleguen a la lógica de negocio.

Clase 1 • Flujos de OAuth 2.0

Mapea los flujos de código de autorización, credenciales de cliente e implícito a los casos de uso. OAuth 2.0 es el estándar de la industria para el acceso delegado.

Clase 2 • Claves de API y autenticación básica

Implementa esquemas de credenciales simples y explica sus limitaciones. Proporciona una base antes de introducir enfoques basados en tokens.

Clase 3 • Autenticación vs. autorización

Distingue la verificación de identidad de la aplicación de permisos. Tener claros estos conceptos evita errores comunes de diseño de seguridad.

Clase 4 • Control de acceso basado en roles

Aplica permisos a nivel de endpoint y recurso usando roles. RBAC asegura que los usuarios accedan solo a los datos que están autorizados a ver.

Clase 1 • Patrones de errores de validación

Maneja los fallos de validación de entrada con retroalimentación precisa y procesable. Los errores de validación son el tipo de error más frecuente en las APIs REST.

Clase 2 • Dominio de los códigos de estado HTTP

Mapea cada clase principal de código de estado a escenarios de uso correcto. Los códigos de estado precisos son la primera señal que los consumidores usan para manejar las respuestas.

Clase 3 • Estándar Problem Details

Aplica el formato de problem details definido por RFC para errores legibles por máquinas. Adoptar un formato estándar mejora la interoperabilidad entre equipos.

Clase 4 • Diseño estructurado de respuestas de error

Define un esquema consistente de cuerpo de error con campos de código, mensaje y detalle. Los errores estructurados reducen el tiempo de depuración para los consumidores de la API.

Clase 1 • Por qué es importante la documentación de API

Establece la documentación como un entregable del producto, no como una idea tardía. Una buena documentación reduce la carga de soporte y acelera la incorporación de los consumidores.

Clase 2 • Documentar endpoints y esquemas

Escribe descripciones de operaciones, parámetros, cuerpos de solicitud y esquemas de respuesta. La documentación completa de los endpoints permite la generación precisa de código de cliente.

Clase 3 • Fundamentos de la especificación OpenAPI

Introduce la estructura de OpenAPI: info, paths, components y servers. La especificación es la única fuente de verdad para el contrato de la API.

Clase 4 • Publicar y mantener la documentación

Renderiza documentación interactiva con Swagger UI y Redoc, y automatiza las actualizaciones. La publicación automatizada mantiene la documentación sincronizada con el código base.

Clase 1 • Limitación de velocidad y estrangulamiento (throttling)

Protege la infraestructura de la API con límites de velocidad y comunica los límites a los clientes. La limitación de velocidad previene el abuso y asegura una distribución justa de los recursos.

Clase 2 • Compresión y optimización de la carga útil

Aplica compresión gzip y Brotli y recorta los datos innecesarios de la carga útil. La compresión reduce significativamente los costos de ancho de banda para las APIs de alto tráfico.

Clase 3 • Patrones de paginación

Implementa paginación por offset, cursor y keyset para colecciones grandes. La elección del patrón correcto afecta el rendimiento y las garantías de consistencia.

Clase 4 • Filtrado, ordenamiento y selección de campos

Agrega controles de parámetros de consulta para filtrar, ordenar y definir conjuntos de campos reducidos (sparse fieldsets). Estas funcionalidades reducen el tamaño de la carga útil y la transferencia de datos innecesaria.

Clase 1 • Seguridad en el transporte y HTTPS

Aplica TLS, configura HSTS y valida certificados. Todas las APIs REST en producción deben cifrar los datos en tránsito sin excepción.

Clase 2 • Estrategias de prueba de APIs

Cubre las pruebas unitarias, de integración y de contrato para endpoints REST. Una estrategia de pruebas en capas detecta los defectos al menor costo posible.

Clase 3 • Monitoreo, registro y observabilidad

Instrumenta las APIs con registros estructurados, métricas y trazas distribuidas. La observabilidad permite un diagnóstico rápido de incidentes en producción.

Clase 4 • Vulnerabilidades de seguridad en APIs REST

Identifica los riesgos de inyección, autenticación rota y exposición excesiva de datos. Comprender los vectores de ataque es un prerrequisito para una mitigación efectiva.