¿Qué es GraphQL?

GraphQL: definición e importancia

Una API es la interfaz mediante la cual los programas intercambian datos. GraphQL es un enfoque en el que el cliente describe en la petición exactamente qué campos necesita, y el servidor entrega solo esos. Los datos se consideran una red de objetos enlazados («grafo»), como cliente, pedidos y artículos.

GraphQL no es una base de datos ni sustituye a la lógica de negocio, sino una capa unificada que se sitúa delante. Detrás pueden estar bases de datos, otras interfaces o sistemas heredados. Hoy muchas plataformas ofrecen GraphQL, entre ellas GitHub y Shopify para sus interfaces, y numerosas empresas lo utilizan en sus propias aplicaciones.

Cómo funciona GraphQL

El servidor publica un esquema que describe todos los tipos, campos y relaciones disponibles. Los clientes envían normalmente, por HTTP POST a un único punto de acceso, una consulta (query) para leer datos o una mutación para modificarlos. Para actualizaciones en tiempo real existen, además, las suscripciones.

Un ejemplo: para una vista general, una aplicación necesita solo el nombre de un cliente y los números de sus tres últimos pedidos. Con una única consulta obtiene exactamente eso. Con una API REST clásica harían falta a menudo varias llamadas, que además devolverían más campos de los necesarios (under- y overfetching).

Ejemplo práctico: unos mismos datos, muchas interfaces

Un fabricante de muebles opera una tienda online, un portal para distribuidores y una app para el servicio externo. Las tres acceden a los mismos datos de producto, pero necesitan porciones distintas: la tienda, imágenes y descripciones; el portal de distribuidores, precios de compra; la app, solo el número de artículo y las existencias. Hasta ahora había tres interfaces separadas.

Con GraphQL, el equipo construye una capa común de la que cada interfaz consulta exactamente los campos que necesita. Los nuevos requisitos a menudo no exigen una interfaz nueva, sino solo una consulta adaptada. Los permisos se comprueban en el servidor, de modo que el portal de distribuidores puede ver los precios de compra y la tienda pública no.

Ventajas, límites y errores habituales

Las ventajas de GraphQL son menos tráfico de datos, un esquema autodescriptivo y un desarrollo rápido de las interfaces de usuario. Frente a ellas hay límites: el almacenamiento en caché es más laborioso que con REST, las consultas abiertas pueden sobrecargar mucho el servidor y el comienzo exige más conocimientos. Errores típicos:

• Usar GraphQL aunque una API REST sencilla sea más que suficiente
• No limitar la profundidad ni la complejidad de las consultas, de modo que una sola puede sobrecargar el servidor
• Comprobar los permisos solo en la interfaz en lugar de en el servidor para cada campo
• Exponer sin protección detalles del esquema y mensajes de error extensos
• Ignorar las consultas N+1 a la base de datos en el servidor

Qué debe tener en cuenta su empresa

Que encaje GraphQL o REST depende del uso: muchos clientes distintos y datos anidados favorecen a GraphQL; las interfaces sencillas y los datos fáciles de almacenar en caché, a REST. Nano Concepts desarrolla ambas variantes, las protege (autenticación, límites, monitorización) y documenta la API para que socios y equipos de frontend puedan usarla con rapidez.