Trong API Design, khi nào nên dùng query params và khi nào nên dùng path params?

Trong thiết kế API, việc sử dụng query params hay path params phụ thuộc vào mục đích và ngữ cảnh sử dụng, dưới đây là một số hướng dẫn để lựa chọn:

Query Params thường được sử dụng khi cần truyền thông tin có thể tùy chọn hoặc cần lọc dữ liệu. Ví dụ, paginating (?page=2&limit=10), tìm kiếm (?search=keyword), hoặc sắp xếp (?sort=asc). Chúng không ảnh hưởng đến cấu trúc URI và giúp giữ cho API endpoint rõ ràng và linh hoạt.

Path Params được sử dụng khi ...