Bỏ qua điều hướng

Prompt miễn phí

Thiết kế API danh sách có phân trang và sắp xếp

Thiết kế API hỗ trợ phân trang, sắp xếp nhiều trường và lọc dữ liệu, kèm chuẩn tham số, response và lưu ý hiệu năng.

Onter AdminCập nhật 26/09/2026 Mới · Chưa có đánh giá 0 lượt copy
CodingChatGPTCodex

Prompt dùng để làm gì?

Thiết kế API hỗ trợ phân trang, sắp xếp nhiều trường và lọc dữ liệu, kèm chuẩn tham số, response và lưu ý hiệu năng.

Điền thông tin của bạn

Prompt

Bạn là kiến trúc sư backend. Hãy thiết kế API danh sách cho bài toán ở {{mo_ta_bai_toan}} sao cho hỗ trợ phân trang ổn định, sắp xếp theo nhiều trường và lọc dữ liệu linh hoạt. Dựa trên yêu cầu truy vấn {{yeu_cau_truy_van}}, hãy đề xuất bộ tham số query, quy ước mặc định, validation cho từng tham số, cấu trúc response chuẩn và các mã lỗi cần có. Nếu có ràng buộc dữ liệu như {{truong_loc}}, {{truong_sap_xep}}, {{gioi_han_phan_trang}}, hãy phản ánh vào thiết kế. Đồng thời nêu các lưu ý hiệu năng: chỉ mục cần thiết, chống truy vấn quá sâu, cách giữ thứ tự ổn định khi phân trang và cách xử lý khi dữ liệu thay đổi giữa các trang. Không cần viết code server đầy đủ, nhưng phải đủ rõ để đội triển khai có thể áp dụng ngay.
Xem đã lưu

Input mẫu

{
"mo_ta_bai_toan": "API danh sách đơn hàng cho dashboard quản trị",
"yeu_cau_truy_van": "lọc theo trạng thái, khoảng ngày và sắp xếp theo ngày tạo hoặc tổng tiền",
"truong_loc": "status, created_at, total_amount",
"truong_sap_xep": "created_at, total_amount",
"gioi_han_phan_trang": "page_size tối đa 100, không cho phép offset quá sâu"
}

Output mẫu

{
"query_params": [
"page",
"page_size",
"sort=created_at:desc,total_amount:asc",
"status",
"created_from",
"created_to"
],
"response_shape": [
"data",
"pagination.total",
"pagination.page",
"pagination.page_size",
"pagination.has_next"
],
"performance_notes": [
"dùng chỉ mục cho created_at và status",
"khuyến nghị cursor pagination nếu offset quá sâu"
]
}

Cách sử dụng

Điền mô tả API, bộ lọc và giới hạn phân trang vào biến phù hợp. Dán vào công cụ thiết kế API hoặc trợ lý backend, rồi kiểm tra lại response, validation và các lưu ý hiệu năng theo yêu cầu riêng của hệ thống.

Giải thích cấu trúc

Role
Vai trò là kiến trúc sư backend thiết kế API truy vấn danh sách.
Context
Bối cảnh là endpoint cần phân trang, sắp xếp đa trường và lọc linh hoạt nhưng vẫn hiệu quả.
Task
Nhiệm vụ là xác định tham số, response và yêu cầu hiệu năng đủ rõ để triển khai.
Constraints
Phải giữ phân trang ổn định, validation rõ ràng và lưu ý các giới hạn truy vấn.
Output
Đầu ra là đặc tả API ngắn gọn nhưng thực dụng, kèm mã lỗi và lưu ý hiệu năng.

Mẹo sử dụng

  • Nên quy định rõ thứ tự ưu tiên khi sort nhiều trường.
  • Nếu dữ liệu lớn, hãy cân nhắc cursor thay cho offset ở phần sâu.
  • Đừng quên trường tổng số bản ghi nếu frontend cần hiển thị trang.
  • Validation nên từ chối field sort không được phép ngay từ đầu.

Nguồn và giấy phép

ONTER biên tập · original

Đánh giá prompt

Chọn số sao theo trải nghiệm của bạn. Bạn có thể sửa đánh giá sau một phút.

Prompt liên quan

Tài khoản Onter

Đăng nhập rồi tiếp tục việc đang làm.

Mở trang đăng nhập riêng nếu trình duyệt chưa hiển thị biểu mẫu.

Contact Me on Zalo