Phỏng vấn theo JD Fullstack
Trang chủ / Chủ đề 6
🔌 Chủ đề 6 / 13 ❓ Câu 40-46

RESTful API

Thiết kế tài nguyên và URL, method & status code, idempotency, phân trang, lọc, versioning, lỗi chuẩn, bảo mật API, rate limit, tài liệu OpenAPI.

📄 Dòng JD tương ứng

RESTful API

📌 Người phỏng vấn muốn kiểm tra điều gì

API là hợp đồng giữa frontend, mobile, đối tác và backend — sửa sai sau khi có người dùng rất đắt. Người phỏng vấn kiểm tra bạn có thiết kế nhất quán, an toàn với retry và dễ tiến hoá không.

📋 Danh sách câu hỏi

  1. 40Nguyên tắc thiết kế REST API tốt? Đặt URL và chọn method thế nào?●○○○ Dễ
  2. 41Idempotency là gì? Làm sao để API tạo đơn hàng/thanh toán an toàn khi client retry?●●○○ Trung bình
  3. 42Phân trang: offset hay cursor? Thiết kế lọc và sắp xếp thế nào?●●○○ Trung bình
  4. 43Versioning API và thay đổi không phá vỡ (backward compatible) thế nào?●●○○ Trung bình
  5. 44Bảo mật REST API: những lỗi phổ biến nhất (OWASP API Top 10)?●●●○ Khó
  6. 45Rate limiting hoạt động thế nào? Thiết kế cho nhiều instance.●●○○ Trung bình
  7. 46REST, GraphQL, gRPC: khi nào chọn cái nào?●●○○ Trung bình
Mẹo: tự trả lời thành tiếng trước, rồi mới mở đáp án.
Câu 40●○○○ Dễ
Nguyên tắc thiết kế REST API tốt? Đặt URL và chọn method thế nào?
Xem câu trả lời & giải thích
💬 Trả lời ngắn (nói trong 30-60 giây)

URL là danh từ số nhiều chỉ tài nguyên (/orders, /orders/{id}/items), method là động từ: GET đọc, POST tạo, PUT thay toàn bộ, PATCH sửa một phần, DELETE xoá. Status code đúng nghĩa, lỗi có định dạng thống nhất, phân trang, versioning, tài liệu OpenAPI. Hành động không khớp CRUD: sub-resource (POST /orders/{id}/cancel) là chấp nhận được.

📖 Giải thích lý thuyết
MãKhi nào
200 / 201 / 204OK / tạo mới (kèm Location) / không có body
400 / 422Request sai cú pháp / sai nghiệp vụ, validate
401 / 403 / 404Chưa xác thực / không có quyền / không tồn tại (hoặc giấu sự tồn tại)
409 / 412Xung đột trạng thái / điều kiện If-Match sai
429Quá giới hạn, kèm Retry-After
500 / 502 / 503 / 504Lỗi server / upstream lỗi / tạm không phục vụ / upstream timeout
🛠️ Áp dụng trong dự án thực tế

Lỗi theo RFC 9457 (application/problem+json: type, title, status, detail, errors[]). Ngày giờ ISO 8601 UTC; tiền là số nguyên + mã tiền tệ.

🎭 Tình huống & câu hỏi nối tiếp

Nối tiếp: "Trả 200 với { success: false } có sao không?" → Phá vỡ cache, monitoring, retry của client và gateway; dùng status code đúng.

🚩 Sai lầm khiến ứng viên mất điểm

URL dạng động từ (/getOrders); mọi lỗi đều 500 hoặc 200.

  • Tôi trả lời được câu này mà không cần xem đáp án
Câu 41●●○○ Trung bình
Idempotency là gì? Làm sao để API tạo đơn hàng/thanh toán an toàn khi client retry?
Xem câu trả lời & giải thích
💬 Trả lời ngắn (nói trong 30-60 giây)

Gọi nhiều lần cho cùng kết quả như gọi một lần. GET, PUT, DELETE idempotent theo định nghĩa; POST thì không. Với POST quan trọng: client gửi header Idempotency-Key (UUID); server lưu key + kết quả, lần sau cùng key trả lại kết quả cũ thay vì tạo mới. Kết hợp ràng buộc unique trong DB.

📖 Giải thích lý thuyết
async create(dto: CreateOrderDto, key: string, userId: string) {
  const existing = await this.idem.find(userId, key);
  if (existing) return existing.response;                  // trả kết quả cũ
  return this.db.transaction(async tx => {
    await tx.insert(idempotencyKeys).values({ userId, key, status: 'processing' }); // unique(userId, key)
    const order = await this.orders.create(tx, dto);
    await tx.update(idempotencyKeys).set({ status: 'done', response: order }).where(...);
    return order;
  });
}

Lưu thêm hash của body để phát hiện cùng key mà khác nội dung (trả 422).

🛠️ Áp dụng trong dự án thực tế

Mạng mobile chập chờn, người dùng bấm hai lần, gateway tự retry — đều tạo đơn trùng nếu không có idempotency. Webhook nhận vào cũng phải idempotent theo event id.

🎭 Tình huống & câu hỏi nối tiếp

Nối tiếp: "Hai request cùng key đến đồng thời?" → Unique constraint đảm bảo chỉ một cái insert được; cái còn lại chờ hoặc trả 409.

🚩 Sai lầm khiến ứng viên mất điểm

Chỉ dựa vào disable nút ở frontend.

  • Tôi trả lời được câu này mà không cần xem đáp án
Câu 42●●○○ Trung bình
Phân trang: offset hay cursor? Thiết kế lọc và sắp xếp thế nào?
Xem câu trả lời & giải thích
💬 Trả lời ngắn (nói trong 30-60 giây)

Offset (?page=40&limit=20) đơn giản, nhảy trang được nhưng chậm với bảng lớn (DB phải bỏ qua N dòng) và lệch dữ liệu khi có bản ghi mới chèn. Cursor/keyset (?after=<createdAt,id>) nhanh, ổn định — hợp feed, infinite scroll, API công khai. Lọc/sắp xếp qua query param có allowlist cột.

📖 Giải thích lý thuyết
-- Keyset: dùng index (created_at, id)
SELECT * FROM orders WHERE (created_at, id) < ($1, $2) ORDER BY created_at DESC, id DESC LIMIT 21;

Response: { data, nextCursor } (cursor mã hoá base64 để client không phụ thuộc cấu trúc). Giới hạn limit tối đa.

🛠️ Áp dụng trong dự án thực tế

Admin cần nhảy trang + tổng số → offset với giới hạn trang hoặc ước lượng count; API mobile → cursor.

🎭 Tình huống & câu hỏi nối tiếp

Tình huống: "Trang 5000 của danh sách đơn mất 3 giây." → OFFSET lớn; chuyển keyset.

🚩 Sai lầm khiến ứng viên mất điểm

Cho phép limit=100000; sort theo cột người dùng truyền vào mà không allowlist (SQL injection qua ORDER BY).

  • Tôi trả lời được câu này mà không cần xem đáp án
Câu 43●●○○ Trung bình
Versioning API và thay đổi không phá vỡ (backward compatible) thế nào?
Xem câu trả lời & giải thích
💬 Trả lời ngắn (nói trong 30-60 giây)

Ưu tiên thay đổi cộng thêm: thêm field, thêm endpoint, thêm giá trị optional — client cũ không vỡ. Thay đổi phá vỡ (đổi tên, xoá field, đổi kiểu, đổi nghĩa) → version mới (/v2 hoặc header), chạy song song, thông báo deprecate (Deprecation, Sunset header), đo lượng client còn dùng bản cũ trước khi tắt.

📖 Giải thích lý thuyết

Client nên bỏ qua field không biết (tolerant reader). Contract test (Pact) hoặc so sánh OpenAPI trong CI (oasdiff) để phát hiện thay đổi phá vỡ trước khi merge.

🛠️ Áp dụng trong dự án thực tế

App mobile không ép cập nhật được → bản cũ sống nhiều tháng; backend phải hỗ trợ ít nhất N phiên bản app.

🎭 Tình huống & câu hỏi nối tiếp

Nối tiếp: "Cần đổi price từ số sang object {amount, currency}." → Thêm priceV2/field mới, giữ field cũ, deprecate dần.

🚩 Sai lầm khiến ứng viên mất điểm

Đổi kiểu field âm thầm.

  • Tôi trả lời được câu này mà không cần xem đáp án
Câu 44●●●○ Khó
Bảo mật REST API: những lỗi phổ biến nhất (OWASP API Top 10)?
Xem câu trả lời & giải thích
💬 Trả lời ngắn (nói trong 30-60 giây)

Đứng đầu là BOLA/IDOR — kiểm tra đăng nhập nhưng không kiểm tra quyền trên đối tượng (GET /orders/123 của người khác). Tiếp theo: xác thực yếu, lộ field thừa/mass assignment, không giới hạn tài nguyên (rate limit, kích thước), phân quyền theo chức năng sai (user gọi API admin), SSRF, cấu hình sai (CORS * + credentials), không kiểm kê API cũ.

📖 Giải thích lý thuyết
  • Mọi truy vấn lọc theo owner/tenant: WHERE id = $1 AND tenant_id = $2.
  • DTO cho input (whitelist) và output (không trả hash, nội bộ).
  • Rate limit theo user/IP/key; timeout; giới hạn body.
  • CORS allowlist; HTTPS; security headers; log truy cập có request id.
🛠️ Áp dụng trong dự án thực tế

Test tự động cho IDOR: user A gọi tài nguyên của B phải nhận 404. Dùng ID khó đoán (UUID) chỉ là lớp phụ, không thay kiểm tra quyền.

🎭 Tình huống & câu hỏi nối tiếp

Tình huống: "Pentest báo có thể đổi userId trong body để đặt hàng hộ người khác." → Lấy userId từ token, không từ body.

🚩 Sai lầm khiến ứng viên mất điểm

Nghĩ UUID là đủ bảo mật.

  • Tôi trả lời được câu này mà không cần xem đáp án
Câu 45●●○○ Trung bình
Rate limiting hoạt động thế nào? Thiết kế cho nhiều instance.
Xem câu trả lời & giải thích
💬 Trả lời ngắn (nói trong 30-60 giây)

Giới hạn số request trong một khoảng thời gian theo key (user, API key, IP). Thuật toán: fixed window (đơn giản, dồn ở biên), sliding window, token bucket (cho phép burst ngắn). Nhiều instance → trạng thái đếm đặt ở Redis (script Lua nguyên tử); trả 429 + Retry-After + header RateLimit-*.

📖 Giải thích lý thuyết

Đặt nhiều tầng: gateway/WAF (Cloud Armor) chặn tấn công lớn, ứng dụng giới hạn theo nghiệp vụ (gửi OTP 3 lần/giờ). Phân biệt giới hạn theo gói (free/pro).

🛠️ Áp dụng trong dự án thực tế

NestJS: @nestjs/throttler với storage Redis. Client nên retry với exponential backoff + jitter khi gặp 429/503.

🎭 Tình huống & câu hỏi nối tiếp

Nối tiếp: "Đặt rate limit theo IP có vấn đề gì?" → Người dùng sau NAT công ty chung IP; kẻ tấn công đổi IP. Kết hợp theo user/key.

🚩 Sai lầm khiến ứng viên mất điểm

Đếm trong bộ nhớ từng instance.

  • Tôi trả lời được câu này mà không cần xem đáp án
Câu 46●●○○ Trung bình
REST, GraphQL, gRPC: khi nào chọn cái nào?
Xem câu trả lời & giải thích
💬 Trả lời ngắn (nói trong 30-60 giây)

REST: mặc định cho API công khai, dễ cache HTTP, công cụ phổ biến. GraphQL: nhiều client cần hình dạng dữ liệu khác nhau, tránh over/under-fetching — đổi lại phức tạp cache, N+1 (cần DataLoader), giới hạn độ sâu query. gRPC: service-to-service nội bộ, hiệu năng cao, streaming, hợp đồng protobuf chặt — không chạy trực tiếp trên trình duyệt.

📖 Giải thích lý thuyết

Trong dự án TypeScript fullstack còn có tRPC (kiểu xuyên suốt client–server cùng repo) và Server Actions của Next.js cho mutation nội bộ.

🛠️ Áp dụng trong dự án thực tế

Mô hình hay gặp: REST/OpenAPI cho đối tác & mobile, gRPC hoặc Pub/Sub giữa service, Next.js gọi API qua BFF.

🎭 Tình huống & câu hỏi nối tiếp

Nối tiếp: "Bạn có chuyển REST sang GraphQL để 'hiện đại' không?" → Chỉ khi có vấn đề cụ thể (nhiều client, nhiều round-trip); chi phí vận hành tăng.

🚩 Sai lầm khiến ứng viên mất điểm

Chọn công nghệ theo xu hướng.

  • Tôi trả lời được câu này mà không cần xem đáp án