Definición: Lenguaje de consulta para APIs que permite a los clientes solicitar exactamente los datos que necesitan, reduciendo el over-fetching y under-fetching.
— Fuente: NERVICO, Consultoría de Desarrollo de Producto
Que es GraphQL
GraphQL es un lenguaje de consulta para APIs y un runtime para ejecutar esas consultas, desarrollado originalmente por Facebook en 2012 y publicado como codigo abierto en 2015. A diferencia de REST, donde cada endpoint devuelve una estructura fija de datos, GraphQL permite a los clientes especificar exactamente que campos necesitan en una sola peticion.
Como funciona
El servidor define un esquema (schema) que describe todos los tipos de datos disponibles y sus relaciones. Los clientes envian consultas (queries) que especifican la forma exacta de los datos que necesitan. El servidor resuelve la consulta utilizando funciones llamadas resolvers, que obtienen los datos de las fuentes correspondientes (bases de datos, servicios externos, cache). Las mutations permiten modificar datos, y las subscriptions habilitan comunicacion en tiempo real. Todo se expone a traves de un unico endpoint, en contraste con los multiples endpoints de una API REST.
Por que importa
GraphQL resuelve dos problemas comunes de las APIs REST: el over-fetching (recibir mas datos de los necesarios) y el under-fetching (necesitar multiples peticiones para obtener toda la informacion). Para aplicaciones moviles con ancho de banda limitado o interfaces complejas que combinan datos de multiples fuentes, GraphQL reduce significativamente el numero de peticiones y el volumen de datos transferidos, mejorando el rendimiento y la experiencia de desarrollo.
Ejemplo practico
Una aplicacion movil necesita mostrar el perfil de un usuario con su nombre, foto y las tres ultimas compras. Con REST, esto requeriria como minimo dos peticiones: una a /users/123 y otra a /users/123/orders. Con GraphQL, una sola consulta obtiene exactamente los campos necesarios. Si otra pantalla solo necesita el nombre del usuario, envia una consulta que solicita unicamente ese campo, sin recibir datos adicionales.
Terminos relacionados
- REST API - Estilo arquitectonico alternativo para APIs con el que GraphQL se compara frecuentemente
- API Gateway - Punto de entrada que puede enrutar tanto peticiones REST como GraphQL
- Microservicios - Arquitectura donde GraphQL puede actuar como capa de agregacion
Ultima actualizacion: Febrero 2026