API Design & Giao tiếp giữa Service
REST vs gRPC vs GraphQL, Synchronous vs Asynchronous communication, API versioning, và API Gateway pattern.
Một khi ranh giới Bounded Context đã rõ (Module 4), câu hỏi tiếp theo là chúng nói chuyện với nhau như thế nào. Chọn sai kiểu giao tiếp (đồng bộ khi lẽ ra nên bất đồng bộ, REST khi lẽ ra nên gRPC nội bộ) tạo ra coupling chặt và các vấn đề hiệu năng khó sửa về sau khi hệ thống đã lớn.
🎯 Mục tiêu học tập
- So sánh REST, gRPC, GraphQL và chọn đúng theo tình huống giao tiếp cụ thể
- Phân biệt Synchronous và Asynchronous communication, hiểu đánh đổi coupling/độ phức tạp
- Thiết kế API versioning không phá vỡ client hiện có
- Hiểu vai trò API Gateway trong kiến trúc microservices/modular
REST vs gRPC vs GraphQL
| Kiểu | Đặc điểm | Phù hợp nhất cho |
|---|---|---|
| REST | Dựa HTTP, dễ hiểu, dễ debug (curl/browser), hệ sinh thái công cụ rộng lớn | Public API, giao tiếp giữa các team/tổ chức khác nhau, khi đơn giản và tương thích rộng quan trọng hơn hiệu năng tối đa |
| gRPC | Dựa HTTP/2 + Protocol Buffers (binary, nhỏ gọn hơn JSON nhiều), hỗ trợ streaming 2 chiều, strict schema (.proto) | Giao tiếp nội bộ giữa service (service-to-service), cần hiệu năng cao, độ trễ thấp, nhiều microservices gọi nhau liên tục |
| GraphQL | Client tự định nghĩa chính xác dữ liệu cần lấy trong 1 request, tránh over-fetching/under-fetching | Backend-for-Frontend phục vụ nhiều loại client (web/mobile) với nhu cầu dữ liệu khác nhau đáng kể |
Không cần chọn 1 kiểu duy nhất cho toàn hệ thống — phổ biến là kết hợp: REST/GraphQL cho API hướng ra ngoài (client-facing), gRPC cho giao tiếp nội bộ giữa service (nơi hiệu năng và type-safety quan trọng hơn khả năng debug bằng trình duyệt).
Synchronous vs Asynchronous Communication
Synchronous (gọi trực tiếp, chờ phản hồi ngay — REST/gRPC request thông thường): đơn giản để suy luận (dễ theo dõi luồng xử lý), nhưng tạo coupling thời gian — service gọi phải chờ service được gọi phản hồi, nếu service đó chậm/chết, toàn bộ chuỗi bị ảnh hưởng theo (rủi ro "cascading failure" — liên hệ Module 9).
Asynchronous (qua message queue/event — Kafka, RabbitMQ, SQS): service gửi message rồi tiếp tục ngay, không chờ — giảm coupling thời gian, tăng khả năng chịu lỗi (service nhận có thể tạm thời offline, message vẫn đợi trong queue), nhưng đánh đổi bằng độ phức tạp suy luận cao hơn (không còn "request-response" tuyến tính dễ theo dõi, cần distributed tracing — khoá DevOps Module 7 — để debug hiệu quả) và thường chỉ đạt Eventual Consistency (Module 2).
Dùng Synchronous khi client cần biết kết quả ngay lập tức để quyết định bước tiếp theo (ví dụ: kiểm tra tồn kho trước khi cho phép đặt hàng). Dùng Asynchronous khi hành động có thể xử lý trễ một chút mà không ảnh hưởng trải nghiệm (gửi email xác nhận, cập nhật số liệu thống kê, đồng bộ dữ liệu sang hệ thống khác).
API Versioning — không phá vỡ Client hiện có
| Chiến lược | Ví dụ | Đánh giá |
|---|---|---|
| URI versioning | /v1/orders, /v2/orders | Rõ ràng, dễ hiểu, dễ routing ở API Gateway — phổ biến nhất |
| Header versioning | Accept: application/vnd.myapi.v2+json | URL sạch hơn nhưng khó test/debug thủ công hơn |
| Additive-only changes | Chỉ thêm field mới (optional), không bao giờ xoá/đổi kiểu field cũ | Tránh cần versioning hoàn toàn cho phần lớn thay đổi — nên là chiến lược mặc định trước khi cần bump version |
Nguyên tắc quan trọng nhất không phải "chọn chiến lược nào" mà là có quy trình rõ ràng để deprecate version cũ: thông báo trước, đặt thời hạn (sunset date) rõ ràng, theo dõi ai còn dùng version cũ trước khi tắt hẳn — phá vỡ client mà không báo trước là lỗi kiến trúc nghiêm trọng ảnh hưởng trực tiếp đến uy tín.
API Gateway Pattern
Khi có nhiều service (Modular Monolith với nhiều module, hoặc microservices thật), API Gateway đứng ở cửa ngõ, đóng vai trò: routing request đến đúng service, xử lý cross-cutting concerns tập trung (authentication, rate limiting — liên hệ khoá AI Engineer Module 10, logging), và ẩn cấu trúc nội bộ khỏi client bên ngoài (client chỉ thấy 1 endpoint duy nhất, không cần biết có bao nhiêu service đứng sau). Đánh đổi: Gateway trở thành 1 điểm lỗi tiềm ẩn (single point of failure) nếu không được thiết kế high-availability đúng cách (Module 2, 9).
🏋️ Bài tập thực hành
Với Context Map đã vẽ ở Module 4, với mỗi quan hệ giữa 2 Bounded Context, quyết định: giao tiếp Synchronous hay Asynchronous, và nếu Synchronous thì REST hay gRPC. Giải thích lý do cho từng quyết định dựa trên tính chất nghiệp vụ (cần biết kết quả ngay hay có thể trễ). Thiết kế 1 chiến lược versioning cho 1 API cụ thể trong hệ thống đó.
📚 Tài nguyên học tập
-
Google — gRPC documentationTài liệu chính thức gRPCDocs
-
GraphQL — Official documentationTài liệu chính thức GraphQLDocs
-
Microsoft — API Gateway patternGiải thích chi tiết API Gateway patternDocs
✅ Tự đánh giá hoàn thành
- So sánh và chọn đúng REST/gRPC/GraphQL theo tình huống cụ thể
- Quyết định đúng Synchronous vs Asynchronous cho từng loại giao tiếp
- Thiết kế được chiến lược API versioning có quy trình deprecate rõ ràng
- Giải thích được vai trò và rủi ro của API Gateway