1. Định nghĩa
GraphQL là một ngôn ngữ truy vấn (query language) dành cho API, được Meta (Facebook) phát triển từ năm 2012 và phát hành mã nguồn mở vào năm 2015. Khác với REST – nơi server định nghĩa sẵn các endpoint và trả về một cấu trúc dữ liệu cố định – GraphQL cho phép client (frontend) tự khai báo chính xác dữ liệu mình cần, và server chỉ trả về đúng những trường đó.
Trong bối cảnh DTC/thương mại điện tử, GraphQL thường được dùng làm lớp giao tiếp giữa storefront (Next.js, Hydrogen, Vue Storefront…) và backend (Shopify Storefront API, Saleor, Medusa, Commerce Layer…). Đây là “xương sống” của kiến trúc Headless Commerce – nơi giao diện tách rời khỏi hệ thống quản lý bán hàng.
2. Ẩn dụ dễ hiểu
Hãy tưởng tượng bạn gọi món ở một nhà hàng:
- REST giống như buffet cố định: bạn gọi “Combo A”, nhà bếp mang ra đủ món – kể cả món bạn không ăn. Muốn thêm món khác? Phải gọi thêm combo khác (nhiều request).
- GraphQL giống như gọi món theo yêu cầu: bạn nói “cho tôi 200g bò, 1 chén salad, không cà chua”, nhà bếp trả về đúng thứ đó trong một lần phục vụ.
Với một shop DTC có 50.000 SKU, sự khác biệt này tiết kiệm cực nhiều băng thông và thời gian tải trang – đặc biệt trên mobile 4G.
3. Công thức & cấu trúc
Một truy vấn GraphQL cơ bản có dạng:
query {
product(id: "gid://shopify/Product/123") {
title
priceRange { minVariantPrice { amount currencyCode } }
variants(first: 10) { edges { node { id title availableForSale } } }
}
}
Công thức ước lượng payload:
Payload (KB) = Σ (số trường được yêu cầu × kích thước trung bình mỗi trường)
So sánh thực tế với REST:
- REST /products/123 trả về ~48 KB (bao gồm mô tả, ảnh, metadata không dùng).
- GraphQL query tương đương chỉ trả về ~6 KB → giảm 87%.
- Với 1.000 lượt xem sản phẩm/ngày, tiết kiệm ~42 MB/ngày băng thông.
4. Bảng so sánh REST vs GraphQL
| Tiêu chí | REST | GraphQL |
|---|---|---|
| Endpoint | Nhiều (`/products`, `/cart`, `/orders`) | Một (`/graphql`) |
| Over-fetching | Thường xuyên | Hầu như không |
| Under-fetching | Phải gọi nhiều request | Một query lấy đủ |
| Versioning | `/v1/`, `/v2/` | Schema tiến hoá, không cần version |
| Cache CDN | Dễ (HTTP cache) | Khó hơn (cần persisted query) |
| Học ban đầu | Thấp | Trung bình – cao |
| Phù hợp | Web truyền thống, CMS đơn giản | Headless commerce, app đa nền tảng |
5. Ứng dụng trong DTC/Thương mại điện tử
a) Storefront đa kênh: Một schema GraphQL duy nhất phục vụ web, app iOS, app Android, POS. Mỗi kênh query đúng trường cần – web cần SEO metadata, app chỉ cần ảnh + giá.
b) Giỏ hàng realtime: Mutation cartCreate, cartLinesAdd cho phép cập nhật giỏ hàng tức thời mà không cần reload. Shopify Hydrogen dùng mô hình này đạt TTFB < 200 ms ở 95% request.
c) Cá nhân hoá: Kết hợp GraphQL với recommendation engine – query trả về sản phẩm gợi ý theo user ID, lịch sử mua, và tồn kho theo vùng.
d) Đồng bộ đa hệ thống: Một query gọi đồng thời Product Service (Node), Pricing Service (Go), Inventory Service (Python) qua GraphQL Federation – giảm số round-trip từ 8 xuống còn 1.
e) Checkout linh hoạt: Với Shopify Storefront API, toàn bộ luồng checkout có thể chạy qua GraphQL, cho phép tùy biến UI 100% mà không phụ thuộc theme.
6. Những hiểu lầm phổ biến
❌ “GraphQL thay thế database.”
→ Sai. GraphQL chỉ là lớp API. Nó vẫn cần database (PostgreSQL, MongoDB…) hoặc service phía sau.
❌ “GraphQL nhanh hơn REST mặc định.”
→ Không hẳn. GraphQL có thể chậm hơn nếu resolver viết kém (N+1 query). Cần dùng DataLoader để batch request.
❌ “Không cần lo caching.”
→ Sai nghiêm trọng. Vì mọi request đi qua POST /graphql, CDN không cache tự động. Phải dùng Persisted Queries hoặc APQ (Automatic Persisted Queries) để tận dụng CDN.
❌ “Bảo mật đơn giản hơn REST.”
→ Ngược lại. Cần giới hạn query depth, query complexity, và rate limit theo chi phí query – nếu không, một query độc hại có thể làm sập server.
❌ “Chỉ dành cho ông lớn.”
→ Hiện nay Medusa, Saleor, Vendure đều cung cấp GraphQL miễn phí. Một shop DTC 500 đơn/tháng vẫn hưởng lợi.
7. Thuật ngữ liên quan
- Schema – Bản thiết kế các type, query, mutation mà API hỗ trợ.
- Resolver – Hàm xử lý logic trả về dữ liệu cho một trường.
- Mutation – Thao tác ghi (tạo giỏ, đặt hàng, cập nhật địa chỉ).
- Subscription – Kênh realtime (theo dõi tồn kho, trạng thái đơn).
- Federation – Ghép nhiều GraphQL service thành một gateway duy nhất.
- Persisted Query – Query được hash và lưu trước để tối ưu băng thông + CDN.
- Headless Commerce – Kiến trúc tách frontend khỏi backend, thường đi kèm GraphQL.
- N+1 Problem – Lỗi hiệu năng kinh điển khi resolver gọi DB từng item một.
Tóm lại: Với một shop DTC hiện đại, GraphQL không chỉ là “API mới” – nó là cách để đội frontend chủ động về dữ liệu, giảm payload 70–90%, và mở đường cho trải nghiệm mua sắm đa kênh mượt mà. Đổi lại, bạn cần đầu tư vào caching, bảo mật query, và monitoring resolver. Nếu đang cân nhắc chuyển từ REST sang, hãy bắt đầu bằng một trang PDP (product detail page) – đo payload trước/sau, rồi mở rộng dần.
