La “API REST” ha sido durante mucho tiempo el estándar de la industria como método de diseño de API. Sin embargo, en los últimos años, a medida que las interfaces se han vuelto más sofisticadas, un número cada vez mayor de empresas están adoptando GraphQL. Antes de entrar en los detalles técnicos, pensemos primero en la diferencia entre los dos usando la analogía de hacer un pedido en un restaurante.
Limitaciones de la API REST en Restaurantes
REST API es como un “patio de comidas” con diferentes mostradores para cada menú.
Por ejemplo, digamos que quieres pedir un juego de hamburguesas. Primero debes ir al mostrador de hamburguesas (/api/burgers/1), luego al mostrador de papas (/api/sides/potato), y finalmente al mostrador de bebidas (/api/drinks/coke).
Esto requiere la molestia de ir y venir al mostrador muchas veces (múltiples solicitudes). Además, incluso si deseas quitar los pepinillos de tu hamburguesa, el mostrador siempre te dará el producto terminado con pepinillos. Este es un problema llamado “sobrecarga” en el que se recuperan datos innecesarios.
La personalización definitiva llamada GraphQL
GraphQL, por otro lado, es un “camarero personal muy capaz”. Le entrega al camarero una orden (consulta) que dice “hamburguesa (sin pepinillos), papas fritas pequeñas y cola”. Luego, el camarero va a la cocina y saca los artículos que usted especificó en una bandeja.
Esta es la característica más importante de GraphQL. El front-end (cliente) puede especificar exactamente qué datos quiere y en qué forma, y el back-end devolverá la cantidad exacta de datos en consecuencia.
Beneficios de GraphQL y barreras de implementación
Este mecanismo proporciona los siguientes beneficios:
- Reducción del volumen de comunicaciones: En entornos móviles como los teléfonos inteligentes, no adquirir datos innecesarios puede mejorar drásticamente el rendimiento.
- Cambios flexibles en la interfaz de usuario: Incluso si desea agregar nuevos elementos de visualización a la pantalla, no es necesario que el backend cree un nuevo punto final como en REST, y puede hacerlo simplemente reescribiendo la consulta frontal.
Por otra parte, no es una varita mágica. También hay problemas como “difícil de controlar el caché”, “es probable que ocurra un problema N+1” y “la implementación del backend se vuelve más difícil”. Para sitios de blogs simples, la API REST suele ser más fácil y adecuada.
¿Cuál deberías elegir?
GraphQL puede ser la mejor opción para desarrollar aplicaciones web complejas que muestren múltiples tipos de recursos (información del usuario, publicaciones, comentarios, me gusta, etc.) en una sola pantalla. Determina qué tipo de pedidos recibe más tu “restaurante” y elige la arquitectura adecuada.