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.
RESTful API
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
- 40Nguyên tắc thiết kế REST API tốt? Đặt URL và chọn method thế nào?●○○○ Dễ
- 41Idempotency là gì? Làm sao để API tạo đơn hàng/thanh toán an toàn khi client retry?●●○○ Trung bình
- 42Phân trang: offset hay cursor? Thiết kế lọc và sắp xếp thế nào?●●○○ Trung bình
- 43Versioning API và thay đổi không phá vỡ (backward compatible) thế nào?●●○○ Trung bình
- 44Bảo mật REST API: những lỗi phổ biến nhất (OWASP API Top 10)?●●●○ Khó
- 45Rate limiting hoạt động thế nào? Thiết kế cho nhiều instance.●●○○ Trung bình
- 46REST, GraphQL, gRPC: khi nào chọn cái nào?●●○○ Trung bình
Xem câu trả lời & giải thích
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.
| Mã | Khi nào |
|---|---|
| 200 / 201 / 204 | OK / tạo mới (kèm Location) / không có body |
| 400 / 422 | Request sai cú pháp / sai nghiệp vụ, validate |
| 401 / 403 / 404 | Chư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 / 412 | Xung đột trạng thái / điều kiện If-Match sai |
| 429 | Quá giới hạn, kèm Retry-After |
| 500 / 502 / 503 / 504 | Lỗi server / upstream lỗi / tạm không phục vụ / upstream timeout |
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ệ.
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.
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
Xem câu trả lời & giải thích
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.
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).
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.
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.
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
Xem câu trả lời & giải thích
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.
-- 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.
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: "Trang 5000 của danh sách đơn mất 3 giây." → OFFSET lớn; chuyển keyset.
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
Xem câu trả lời & giải thích
Ư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.
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.
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.
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.
Đổ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
Xem câu trả lời & giải thích
Đứ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ũ.
- 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.
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: "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.
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
Xem câu trả lời & giải thích
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-*.
Đặ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).
NestJS: @nestjs/throttler với storage Redis. Client nên retry với exponential backoff + jitter khi gặp 429/503.
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.
Đế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
Xem câu trả lời & giải thích
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.
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ộ.
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.
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.
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