Các Kiểu Kiến Trúc API Phổ Biến Nhất Hiện Nay

API (Application Programming Interface) là giao diện lập trình ứng dụng, cung cấp một tập hợp các quy tắc và phương thức giúp các phần mềm hoặc dịch vụ khác nhau có thể giao tiếp với nhau

API hoạt động như cầu nối giữa các hệ thống, cho phép chúng trao dổi dữ liệu và thực hiện các chức năng mà không cần hiểu rõ cách hệ thống nội bộ hoạt động

SOAP là một giao thức nhắn tin dựa trên XML để trao đổi dữ liệu giữa các hệ thống trong môi trường phân tán. SOAP hoạt động chủ yếu qua HTTP, nhưng cũng có thể sử dụng SMTP, TCP hoặc

🔹Mô tả: Là một kiến trúc API phổ biến nhất, dựa trên giao thức HTTP và sử dụng các phương thức GET, POST, PUT, DELETE

🔹 Ưu điểm:

🔹 Nhược điểm:

GET /users/123

{
  "id": 123,
  "name": "Phi Long",
  "email": "long@example.com",
  "address": {
    "street": "123 Lê Văn Sỹ",
    "city": "HCM"
  },
  "created_at": "2024-02-19T10:00:00Z",
  "updated_at": "2024-02-19T12:00:00Z"
}

GET /posts/1

{
  "id": 1,
  "title": "REST API có nhược điểm gì?",
  "author_id": 123
}

GET /users/123

GET /users/123?fields=name,email

{
  "name": "Phi Long",
  "email": "long@example.com"
}

app.get('/users/:id', async (req, res) => {
  const { id } = req.params;
  const fields = req.query.fields ? req.query.fields.split(',') : ['*'];

  const user = await db('users').select(fields).where({ id }).first();
  res.json(user);
});

Mô tả: Cho phép client yêu cầu chính xác dữ liệu cần, thay vì nhận toàn bộ dữ liệu như REST.

🔹Ưu điểm:

✔ Giải quyết vấn đề Over-fetching & Under-fetching.

✔ Giao tiếp nhanh, giảm số lượng request.

✔ Hỗ trợ strongly-typed API, dễ dàng phát triển.

🔹 Nhược điểm:

❌ Phức tạp hơn REST.

❌ Cần server đặc thù để xử lý query.

🔹Ứng dụng: API cho web, mobile app, ứng dụng có dữ liệu phức tạp.

🔹Ví dụ: Facebook, GitHub GraphQL API.

🔹 Mô tả: Dựa trên giao thức HTTP/2, sử dụng Protocol Buffers (protobuf) thay vì JSON.

🔹 Ưu điểm:

✔ Tốc độ cao, hiệu suất tối ưu hơn REST và GraphQL.

✔ Hỗ trợ streaming, phù hợp với ứng dụng real-time.

✔ Tích hợp dễ dàng với nhiều ngôn ngữ lập trình.

🔹 Nhược điểm:

❌ Phức tạp hơn REST và GraphQL.

❌ Không dễ debug bằng trình duyệt (vì không sử dụng JSON).

🔹 Ứng dụng: Microservices, hệ thống real-time, IoT.

🔹 Ví dụ: Kubernetes, gRPC API của Google Cloud.

🔹 Mô tả: Giao tiếp 2 chiều giữa Client và Server qua kết nối TCP, phù hợp với ứng dụng real-time

🔹 Ưu điểm:

✔ Kết nối lâu dài, giảm độ trễ

✔ Phù hợp với chat, game, streaming dữ liệu

🔹 Nhược điểm:

❌ Không phù hợp với ứng dụng CRUD thông thường

❌ Cần cơ chế quản lý kết nối phức tạp

🔹 Mô tả: Cung cấp real-time một chiều từ server đến client, dựa trên HTTP

🔹 Ưu điểm:

✔ Nhẹ hơn Websocket

✔ Dễ triển khai với API REST

🔹 Nhược điểm:

❌ Chỉ hỗ trợ truyền dữ liệu từ server - client

❌ Không tối ưu với lượng dữ liệu lớn