API REST vs GraphQL — Cómo Hablan las Apps Modernas con sus Datos

Definición Simple

Una API es la forma en que tu web o app se comunica con el servidor para pedir o guardar datos (usuarios, productos, pedidos). REST y GraphQL son dos estilos de diseñar esa comunicación.

REST (el clásico)

REST organiza la información en endpoints fijos, como archivos en carpetas:

• GET /usuarios → lista de usuarios
• GET /usuarios/5 → un usuario
• POST /pedidos → crear pedido

Cada endpoint devuelve una respuesta predeterminada.

GraphQL (el moderno)

GraphQL ofrece un solo endpoint y tú describes exactamente qué quieres:

query {
  usuario(id: 5) {
    nombre
    pedidos { total fecha }
  }
}

Recibes solo eso, ni más ni menos.

Comparación

| | REST | GraphQL | |---|---|---| | Endpoints | Muchos | Uno solo | | Datos devueltos | Fijos | Exactamente los que pides | | Simplicidad | Simple, conocido | Más flexible, curva de aprendizaje | | Over-fetching | Común (pides de más) | Evitado | | Caché | Fácil (HTTP) | Más complejo | | Velocidad móvil | Puede requerir varias llamadas | Una sola llamada |

Over-fetching y under-fetching (el problema de REST)

Con REST, para mostrar "nombre del usuario y sus 3 últimos pedidos" quizás necesites 2-3 llamadas y recibas datos de más (peso innecesario). Con GraphQL lo pides en una consulta precisa. En móviles con datos limitados, eso importa.

Cuál elegir

• REST: excelente para APIs públicas, simples, cacheables. La mayoría de proyectos.
• GraphQL: brilla en apps móviles complejas y frontends que necesitan combinar datos de muchas fuentes con consultas precisas.

Para la mayoría de webs y negocios en LATAM, REST es suficiente y más sencillo de mantener. GraphQL aporta cuando la complejidad lo justifica.