API và trao đổi dữ liệu: hợp đồng giữa các hệ thống

🔌 API có phải chính cơ sở dữ liệu không?

Không. API là giao diện cho phép phần mềm yêu cầu thao tác theo hợp đồng. Máy chủ có thể đọc cơ sở dữ liệu, gọi dịch vụ khác hoặc tính toán; phía khách không cần biết chi tiết triển khai bên trong.

Ứng dụng gửi HTTP request có method, path, headers và body tới API; API xác thực, xử lí và trả status, headers, dữ liệu JSON — Request và response phải tuân schema, quyền truy cập và cách xử lí lỗi đã công bố.

Thành phần cần đọc

Method biểu thị ý định như đọc, tạo hoặc cập nhật; semantics cụ thể do tài liệu API quy định.
Path và tham số xác định tài nguyên hoặc bộ lọc.
Headers mang metadata, định dạng và thông tin xác thực; body mang dữ liệu khi phù hợp.
Status code phân loại kết quả; nội dung lỗi phải đủ rõ nhưng không rò thông tin nhạy cảm.

⚠️ JSON hợp lệ chưa chắc dữ liệu hợp lệ

Máy chủ còn phải kiểm tra kiểu, miền giá trị, trường bắt buộc, quyền của người gọi và ràng buộc nghiệp vụ. Xác thực danh tính không tự động cấp mọi quyền.

🔎 Tính ổn định của hợp đồng

Đổi tên trường hoặc ý nghĩa giá trị có thể phá ứng dụng khách. Versioning, tương thích ngược, giới hạn tốc độ và idempotency giúp tích hợp bền vững hơn.

📚 Lý thuyết trọng tâm

Mục tiêu: Explain APIs through requests, responses, schemas, status codes and authentication while distinguishing an interface contract from its internal implementation.. Khi học API và trao đổi dữ liệu: hợp đồng giữa các hệ thống, hãy xác định khái niệm, điều kiện áp dụng và mối liên hệ giữa các dữ kiện; không chỉ ghi nhớ kết luận.

🧭 Ví dụ có hướng dẫn

Chọn một tình huống điển hình của bài. Bước 1: ghi dữ kiện và câu hỏi cần giải quyết. Bước 2: chọn khái niệm hoặc quy tắc phù hợp. Bước 3: giải thích từng bước và kiểm tra kết quả với điều kiện ban đầu. Nếu đổi một dữ kiện, hãy dự đoán kết quả thay đổi thế nào.

✍️ Luyện tập

Tóm tắt bài bằng ba ý: khái niệm, điều kiện và kết luận.
Tự tạo một ví dụ đúng và một phản ví dụ; chỉ ra điểm quyết định.
Giải lại ví dụ khi thay đổi một dữ kiện, sau đó nêu cách kiểm chứng.

Checklist tự đánh giá

Tôi giải thích được “vì sao”, không chỉ nêu đáp án.
Tôi nhận ra trường hợp không áp dụng được quy tắc.
Tôi kiểm tra được đơn vị, bằng chứng hoặc tính hợp lí của kết luận.