Las APIs son el sistema nervioso del ecommerce moderno. Conectan la tienda con ERPs, CRMs, logística, marketing, apps móviles y frontends headless. Pero cuando llega el momento de elegir entre REST y GraphQL, la decisión no es trivial. Cada paradigma tiene ventajas reales y limitaciones prácticas que afectan al rendimiento, mantenibilidad y experiencia de desarrollo.
REST en ecommerce
REST (Representational State Transfer) es el estándar dominante. Cada recurso tiene una URL y se manipula con verbos HTTP:
GET /api/products/123→ Obtener productoPOST /api/orders→ Crear pedidoPUT /api/customers/456→ Actualizar cliente
Ventajas: Cacheable por diseño (HTTP cache), tooling maduro, fácil de entender, ampliamente soportado.
Limitaciones: Over-fetching (recibes más datos de los que necesitas), under-fetching (necesitas múltiples peticiones para datos relacionados), versionado de API complejo.
GraphQL en ecommerce
GraphQL permite al cliente especificar exactamente qué datos necesita en una sola petición:
- Consultas flexibles: pide solo los campos que necesitas.
- Una sola petición para datos relacionados (producto + variantes + reviews + stock).
- Schema tipado y autoDocumentado.
- Mutations para escribir datos.
- Subscriptions para datos en tiempo real.
Ventajas: Elimina over/under-fetching, ideal para frontends headless, excelente DX con herramientas como Apollo.
Limitaciones: Caché más complejo (no se puede usar HTTP cache directamente), riesgo de queries costosas, curva de aprendizaje, complejidad en el backend.
APIs en las plataformas ecommerce
Shopify
- REST Admin API: API completa para gestión de tienda (productos, pedidos, clientes).
- GraphQL Admin API: Versión GraphQL de la Admin API, recomendada por Shopify para nuevos desarrollos.
- Storefront API (GraphQL): Para frontends headless (Hydrogen, custom). Solo lectura de catálogo + carrito + checkout.
PrestaShop 9
- Webservice legacy (REST): API REST XML/JSON que existe desde PS 1.5. Funcional pero limitada.
- Admin API (API Platform): Nueva en PS9, basada en API Platform (Symfony). REST con documentación OpenAPI automática.
- GraphQL: No nativo, pero API Platform soporta GraphQL como extensión.
WooCommerce
- REST API: API REST nativa completa (productos, pedidos, clientes, cupones).
- WPGraphQL + WooGraphQL: Extensión GraphQL mantenida por la comunidad. Popular para headless con Next.js.
Magento
- REST API: API REST completa y madura.
- GraphQL API: API GraphQL nativa para storefront. PWA Studio la usa como base.
¿Cuándo usar REST?
- Integraciones server-to-server (ERP, logística, CRM) donde el formato de datos es predecible.
- Webhooks y notificaciones.
- Cuando necesitas caché HTTP agresiva.
- Equipos con experiencia REST y sin necesidad de GraphQL.
¿Cuándo usar GraphQL?
- Frontends headless que necesitan datos flexibles y eficientes.
- Apps móviles con diferentes vistas que requieren datos distintos del mismo endpoint.
- Cuando necesitas datos relacionados en una sola petición (producto + stock + precio por grupo + imágenes).
- Experiencias de compra personalizadas y dinámicas.
¿Necesitas diseñar integraciones API?
En Keliam diseñamos e implementamos integraciones API para ecommerce: REST, GraphQL, webhooks y middleware. Contacta con nosotros.



