REST - HTTP DELETE - ngữ nghĩa - chỉ xóa hậu duệ

Question

Trong dự án của chúng tôi, một danh sách của tất cả các cuốn sách có thể được lấy thông qua REST:

GET http://server/api/books/ 

Một cuốn sách cụ thể có thể được lấy như sau:

GET http://server/api/books/:id/ 

Xóa một cuốn sách cụ thể rất dễ dàng:

DELETE http://server/api/books/:id/ 

Bây giờ, câu hỏi của tôi: những gì nên là kết quả của sự foll owing gọi:

DELETE http://server/api/books/ 

Rõ ràng là tất cả các sách đều bị xóa. Nhưng tài nguyên sách/ cũng có bị xóa không? Tức là, sau khi yêu cầu:

1. nên GET/books/return 200 OK với danh sách trống? hoặc
2. nên GET/books/return 404 không tìm thấy?

Theo thông số kỹ thuật, thông báo rằng URI cụ thể sẽ biến mất sau đó, tôi sẽ chọn tùy chọn thứ hai. Tuy nhiên, điều này làm cho mọi thứ phức tạp và không rõ ràng, theo ý kiến ​​của tôi. Có ý nghĩa hơn khi có danh sách trống sách, thay vì không có sách.

Bạn nghĩ sao?

Answer 1

Tuy nhiên, điều này làm cho những điều phức tạp và unlogic

như thế nào? Bạn đang yêu cầu xóa tài nguyên. Tài nguyên đó bị xóa. Kết quả là nó không còn nữa.

Nếu có bất kỳ điều gì, bạn sẽ thấy khó hiểu khi có nó sau khi bạn xóa nó.

Answer 2

Nếu nó làm cho bạn cảm thấy tốt hơn, giả sử rằng máy chủ có logic tự động tạo lại tài nguyên sách sau khi nó đã bị xóa. :-)

Tôi muốn tìm 200 OK và danh sách trống. Nếu bạn thực sự không thích điều đó sau đó tạo ra một nguồn lực mới gọi là /books/all

và làm

DELETE /Books/all 

Answer 3

Tôi nghĩ rằng cho phép DELETE /books là quá mạo hiểm. Một phần của api được thiết kế tốt là tránh những lỗi "dễ dàng" từ phía api-client. Nó có thể dễ dàng xảy ra rằng trong mã khách hàng một cái gì đó là sai, vô tình id (ví dụ như biến chuỗi rỗng) là mất tích và không mong muốn DELETE /books được gửi đi.

Điều tôi sẽ làm là buộc khách hàng lặp lại thông qua DELETE /books/{id} trong trường hợp anh ấy muốn xóa tất cả sách.

Có lẽ bạn có thể cung cấp thêm dữ liệu đầu vào cho trường hợp sử dụng của mình: Tôi tự hỏi khả năng trường hợp sử dụng là DELETE /books là nguồn gốc được gọi là (nó khá triệt để để xóa tài nguyên gốc). Có thể bạn đang cung cấp xóa tài nguyên phụ, ví dụ: /user/{id}/shopping-cart/{id}/books.Nếu đó là một tài nguyên "thoáng qua" (như giỏ mua hàng) thì việc xóa api cho tất cả các sách sẽ có ý nghĩa hơn.

Về câu hỏi khác của bạn: Đối với /books Tôi sẽ trả lại 200 và danh sách trống. Trong các trường hợp sưu tập, tôi thích các danh sách trống hơn các giá trị 'null'.