Bài viết về: REST API

Cursor Pagination cho API: Phân trang ổn định khi dữ liệu liên tục thay đổi

OFFSET 100000 trông vô hại, nhưng database vẫn phải tìm và bỏ qua một lượng lớn record trước khi trả vài chục dòng. Trong lúc người dùng chuyển trang, dữ liệu mới còn có thể được chèn vào đầu danh sách, khiến một item xuất hiện hai lần hoặc biến mất khỏi hành trình đọc.

Đọc tiếp →

Kiểm thử contract API với OpenAPI: Chặn lỗi tích hợp ngay trong CI

API vẫn trả HTTP 200, nhưng frontend đột nhiên lỗi vì một field biến mất, đổi kiểu hoặc trở thành null. Unit test của backend có thể vẫn xanh, tài liệu Swagger vẫn mở được, nhưng hợp đồng mà consumer đang dựa vào đã bị phá vỡ.

Đọc tiếp →

Thiết kế REST API dễ hiểu, an toàn và dễ mở rộng

Hướng dẫn thiết kế REST API nhất quán và dễ mở rộng: resource, HTTP method, status code, phân trang, lỗi, versioning, bảo mật và tài liệu OpenAPI.

Đọc tiếp →