Thiết kế REST API mà front-end sẽ cảm ơn bạn

Một API được thiết kế tốt giúp cả team đi nhanh hơn; một API tùy hứng khiến ai cũng phải đọc code nguồn.

# Nhất quán và dễ đoán

Dùng danh từ số nhiều cho tài nguyên, mã trạng thái HTTP đúng nghĩa, và định dạng lỗi thống nhất trên mọi endpoint.

# Phân trang từ đầu

Đừng trả về toàn bộ danh sách. Thiết kế phân trang, lọc và sắp xếp ngay từ ngày đầu để tránh phá vỡ hợp đồng API sau này.

• Versioning để tiến hóa an toàn
• Thông báo lỗi rõ ràng, hành động được
• Tài liệu hóa bằng ví dụ thật

API là giao diện người dùng dành cho lập trình viên — hãy đối xử với nó như vậy.