Thiết kế RESTful: Paging Collections

Question

Tôi đang thiết kế một REST api cần phân trang (mỗi x) thi hành từ phía máy chủ.

Điều gì sẽ là đúng cách để trang thông qua bất kỳ tập hợp các nguồn lực:

Lựa chọn 1:

GET /resource/page/<pagenr> 
GET /resource/tags/<tag1>,<tag2>/page/<pagenr> 
GET /resource/search/<query>/page/<pagenr> 

Phương án 2:

GET /resource/?page=<pagenr> 
GET /resource/tags/<tag1>,<tag2>?page=<pagenr> 
GET /resource/search/<query>?page=<pagenr> 

Nếu 1, tôi nên làm gì với GET/tài nguyên? Chuyển hướng đến/resource/page/0, trả lời với một số lỗi hoặc trả lời với chính xác giống như/resource/page/0 mà không chuyển hướng?

Answer 1

Với sự hiểu biết hạn chế của tôi về những gì REST là về, sau đó sau đây có thể là "nhất" yên tĩnh.

GET /resource/?page=<pageenr>&asof=<datetime> 

Vì nội dung của đại diện sẽ không bao giờ thay đổi đột ngột và có thể sử dụng bộ nhớ đệm.

Nhưng để thực sự trả lời câu hỏi của bạn, tôi nghĩ trang tham số là phương thức được ưu tiên.

Answer 2

Tôi muốn sử dụng tùy chọn (2). Tại sao?

1. Sau đó bạn có thể thêm tham số kích thước trang vào truy vấn để khách hàng có thể chỉ định kích thước trang.
2. Trong trường hợp không có thông số trang nào được chỉ định, bạn chỉ có thể trả lại trang đầu tiên (mặc định). Trong nhiều trường hợp, khách hàng của bạn có thể chỉ cần trang đầu tiên, vì vậy nó đơn giản hóa giao thức giữa máy khách và máy chủ.

Answer 3

URI trông như thế nào không phải là phần quan trọng nhất. Những gì bạn nên suy nghĩ về thay vào đó là cách nó được trình bày cho người dùng. Ví dụ, một trang có liên kết đến trang "tiếp theo" và một liên kết khác đến trang "trước đó" (nếu có). Hãy xem RFC 5005 Feed Paging and Archiving