En resumen Usa WebSocket Nativo para una comunicación en tiempo real sencilla con navegadores modernos. Usa Socket.IO cuando necesites reconexión automática, transportes de respaldo o salas/espacios de nombres. Socket.IO añade más de 200 KB de sobrecarga pero maneja casos extremos. Modern PetstoreAPI implementa ambos: WebSocket Nativo para subastas, Socket.IO para el chat. Introducción Necesitas comunicación bidireccional en tiempo real. ¿Deberías usar WebSocket Nativo o Socket.IO? WebSocket

Ashley Innocent

March 13, 2026

En resumen Utiliza MQTT para dispositivos IoT con batería limitada, redes poco fiables o patrones de mensajería pub-sub. Utiliza HTTP para API web/móviles estándar. MQTT usa cabeceras de 2 bytes frente a los más de 100 bytes de HTTP, lo que lo hace ideal para dispositivos con restricciones. Modern PetstoreAPI implementa MQTT para collares de seguimiento de mascotas y comederos inteligentes. Introducción Tu collar de seguimiento de mascotas necesita enviar actualizaciones de ubicación cada 5

Ashley Innocent

March 13, 2026

TL;DR Utilice Eventos Enviados por el Servidor (SSE) para actualizaciones unidireccionales de servidor a cliente, como notificaciones y feeds en vivo. Utilice WebSocket para comunicación bidireccional, como chats y juegos. SSE es más simple y funciona sobre HTTP. WebSocket es más complejo pero soporta mensajería bidireccional. La PetstoreAPI Moderna implementa ambos para diferentes casos de uso en tiempo real. Introducción Necesita actualizaciones en tiempo real en su API. El estado de una m

Ashley Innocent

March 13, 2026

Resumen El Protocolo de Contexto del Modelo (MCP) es un estándar para conectar asistentes de IA a fuentes de datos externas y APIs. Permite que Claude Desktop, Cursor y otras herramientas de IA accedan a tu API de forma segura. Modern PetstoreAPI implementa MCP para que los asistentes de IA puedan buscar mascotas, realizar pedidos y gestionar el inventario a través del lenguaje natural. Introducción Le preguntas a Claude Desktop: “Muéstrame gatos disponibles por menos de $300.” Claude respon

Ashley Innocent

March 13, 2026

En resumen Las APIs basadas en eventos utilizan webhooks para notificaciones externas y colas de mensajes para procesamiento interno. Publica eventos en una cola (RabbitMQ, Kafka), procesa de forma asíncrona y notifica a los clientes a través de webhooks. Modern PetstoreAPI utiliza este patrón para el procesamiento de pedidos, actualizaciones de inventario y notificaciones de pago. Introducción Un cliente realiza un pedido. Tu API necesita cargar el pago, actualizar el inventario, enviar un

Ashley Innocent

March 13, 2026

TL;DR Utilice Server-Sent Events (SSE) para transmitir respuestas de API a través de HTTP. Envíe Content-Type: text/event-stream y escriba eventos como data: {json}\n\n. SSE funciona para la transmisión de respuestas de IA, actualizaciones de progreso y feeds en vivo. Modern PetstoreAPI utiliza SSE para recomendaciones de mascotas con IA y actualizaciones de estado de pedidos. Introducción Su API genera recomendaciones de mascotas con IA. La respuesta tarda 10 segundos. ¿Hace esperar a los u

Ashley Innocent

March 13, 2026

TL;DR Diseña webhooks confiables con reintentos de retroceso exponencial (5-10 intentos), claves de idempotencia, verificación de firma HMAC y tiempos de espera de 5 segundos. Devuelve 2xx inmediatamente, procesa asincrónicamente. Modern PetstoreAPI implementa webhooks para actualizaciones de pedidos, adopciones de mascotas y notificaciones de pago con reintentos y seguridad completos. Introducción Envías un webhook para notificar a un cliente que su mascota fue adoptada. El servidor del cli

Ashley Innocent

March 13, 2026

En resumen (TL;DR) Los ámbitos (scopes) de OAuth 2.0 son cadenas de permisos que definen lo que un token de acceso puede hacer. Utilice el formato recurso:acción como pets:read o orders:write. Solicite los ámbitos durante la autorización, y valídelos en los puntos finales de la API. La Modern PetstoreAPI implementa ámbitos para el acceso de lectura/escritura a mascotas, pedidos y datos de usuario. Introducción Una aplicación de terceros quiere leer el inventario de su tienda de mascotas. ¿De

Ashley Innocent

March 13, 2026

En resumen Usa REST para APIs públicas y operaciones CRUD simples. Usa GraphQL cuando los clientes necesiten una obtención de datos flexible y quieras reducir la sobre-obtención (over-fetching). Usa gRPC para la comunicación de microservicios de alto rendimiento. La Modern PetstoreAPI implementa los tres protocolos, permitiéndote elegir la herramienta adecuada para cada caso de uso. Introducción Estás construyendo una API. ¿Deberías usar REST, GraphQL o gRPC? Cada protocolo tiene defensores

Ashley Innocent

March 13, 2026

TL;DR OpenAPI 3.1 añadió compatibilidad total con JSON Schema, webhooks y mejoras en el discriminador. OpenAPI 3.2 añadió soporte para el método QUERY, ejemplos mejorados y mejores definiciones de seguridad. Modern PetstoreAPI utiliza OpenAPI 3.2 para demostrar las últimas características con ejemplos listos para producción. Introducción Estás escribiendo una especificación OpenAPI. Ves referencias a OpenAPI 3.0, 3.1 y 3.2. ¿Cuál es la diferencia? ¿Deberías actualizar? ¿Tus herramientas sopo

Ashley Innocent

March 13, 2026

TL;DR Construye APIs multiprotocolo separando la lógica de negocio de las capas de protocolo. Crea una capa de dominio compartida, luego añade adaptadores REST, GraphQL y gRPC encima. Modern PetstoreAPI demuestra esta arquitectura con modelos de datos consistentes en los tres protocolos. Introducción Tu API sirve a clientes web, aplicaciones móviles y microservicios internos. Los clientes web quieren REST por su simplicidad. Las aplicaciones móviles quieren GraphQL para reducir la transferen

Ashley Innocent

March 13, 2026

¿Deberían las API REST implementar enlaces de hipermedia HATEOAS? En resumen HATEOAS (Hypermedia as the Engine of Application State) es teóricamente elegante pero prácticamente complejo. La mayoría de las API omiten la implementación completa de HATEOAS y utilizan enlaces de hipermedia selectivos para la paginación, los recursos relacionados y las acciones. La Modern PetstoreAPI implementa enlaces de hipermedia prácticos sin obligar a los clientes a depender totalmente de la hipermedia. Int

Ashley Innocent

March 13, 2026

En resumen Implemente la limitación de tasa de API utilizando algoritmos de cubo de fichas (token bucket) o ventana deslizante. Devuelva los encabezados estándar de limitación de tasa del IETF (RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset) y 429 Demasiadas Solicitudes cuando se superen los límites. Modern PetstoreAPI implementa la limitación de tasa con cuotas por usuario y respuestas de error claras. Introducción Un cliente realiza 10.000 solicitudes a su API en un minuto. Su base

Ashley Innocent

March 13, 2026

En Resumen El versionado por URL (/v1/pets) es la estrategia de versionado de API más práctica para la mayoría de los equipos. Es visible, cacheable y fácil de probar. El versionado por cabecera y la negociación de contenido son REST más "puros" pero añaden complejidad. Modern PetstoreAPI utiliza el versionado por URL con versionado semántico y políticas claras de deprecación. Introducción Tu API necesita un cambio drástico. Estás cambiando el formato de respuesta para /pets de un array simp

Ashley Innocent

March 13, 2026

En resumen Para conjuntos de datos grandes, utiliza la paginación basada en cursor o en claves en lugar de la paginación basada en desplazamiento (offset). La paginación por desplazamiento (?page=1&limit=20) tiene un rendimiento deficiente con millones de registros y permite la inconsistencia de datos. Modern PetstoreAPI implementa la paginación basada en cursor con tokens opacos y enlaces HATEOAS para obtener resultados eficientes y consistentes. Introducción Tu API devuelve una lista de ma

Ashley Innocent

March 13, 2026