Đây là bài 2 của chương 3: API và idempotency, thuộc khóa demo System Design. Nội dung được dùng để trải nghiệm cấu trúc chương trình học; hãy thực hành trên dữ liệu và môi trường thử nghiệm riêng. Trong dự án xuyên suốt, bạn sẽ xây dựng bản thiết kế nền tảng học trực tuyến với danh mục, video, tiến độ và thông báo.
Mục tiêu cụ thể
API cần hợp đồng đầu vào, đầu ra và lỗi. Idempotency giúp client gửi lại thao tác mà không gây tác dụng phụ trùng trong điều kiện đã xác định.
Đọc ví dụ theo luồng dữ liệu
Đọc từ đầu vào tới đầu ra. Xác định từng tên, điều kiện và quan hệ phụ thuộc trước khi chạy. Nếu có tên model, bảng hoặc endpoint chưa tồn tại, coi đó là thành phần minh họa cần dựng trong dự án thử nghiệm; đoạn trích không đại diện một ứng dụng hoàn chỉnh.
POST /enrollments
Idempotency-Key: demo-request-123
Body: {"course_id": 42}
Server lưu khóa, fingerprint của request và kết quả.
Cùng khóa nhưng payload khác cần bị từ chối.Cách phân tích
- Đánh dấu phần khai báo và phần thực hiện thao tác.
- Dự đoán kết quả với dữ liệu thông thường trước khi chạy.
- Thay đúng một giá trị đầu vào để kiểm tra dự đoán.
- Ghi lại kết quả thực tế, không chỉ thông báo thành công.
Tình huống đối chiếu
Chỉ thêm header không tự tạo idempotency. Cần lưu trạng thái, xử lý request đồng thời và chính sách hết hạn.
Hãy liên hệ ví dụ với yêu cầu của chương: Thiết kế hợp đồng đăng ký khóa học có thể retry sau timeout; mô tả trường hợp hai request đến cùng lúc. Chỗ nào có thể dùng lại trực tiếp, chỗ nào phải đổi vì dữ liệu hoặc môi trường khác? Giải thích sự khác biệt đó giúp tránh việc sao chép một mẫu đúng trong bối cảnh này nhưng sai trong bối cảnh khác.
Bài tập đọc hiểu
- Chỉ ra phần nào của ví dụ giúp bảo đảm: request lặp có kết quả nhất quán.
- Chỉ ra phần nào của ví dụ giúp bảo đảm: payload khác không dùng chung khóa.
- Chỉ ra phần nào của ví dụ giúp bảo đảm: có chính sách lưu và hết hạn khóa.
Nộp lại bản chú thích ngắn, kết quả quan sát và một biến thể đã thử. Nếu ví dụ chưa đủ để đạt một tiêu chí, liệt kê phần cần bổ sung thay vì coi tiêu chí đã tự động được thỏa mãn.