Hoạt động không CRUD trong một dịch vụ RESTful

Cách "RESTful" để thêm các hoạt động không phải CRUD vào dịch vụ RESTful là gì? Giả sử tôi có một dịch vụ cho phép CRUD truy cập vào các bản ghi như sau:

GET /api/car/123           <- Returns information for the Car object with ID 123
POST /api/car              <- Creates a new car (with properties in the request)
PUT /api/car/123           <- Updates car 123 (with properties in the request)
DELETE /api/car/123        <- Deletes car 123    
POST /api/car/123/wheel/   <- Creates a wheel and associates it to car 123

Nếu tôi muốn thay đổi màu của chiếc xe, tôi chỉ cần POST /api/car/123thêm một biến POST cho màu mới.

Nhưng giả sử tôi muốn mua một chiếc ô tô và thao tác đó phức tạp hơn là chỉ cập nhật tài sản “ô tô đã sở hữu” của bản ghi "người dùng". Nó có RESTful chỉ đơn giản là làm một cái gì đó như POST /api/car/123/purchase, trong đó "mua" về cơ bản là một tên phương thức? Hay tôi nên sử dụng một động từ HTTP tùy chỉnh, như PURCHASEthay vì POST?

Hay các hoạt động không phải CRUD hoàn toàn nằm ngoài phạm vi của REST?

Hãy nghĩ về việc mua hàng như một thực thể kinh doanh hoặc một tài nguyên trong từ điển RESTful. Nói như vậy, việc mua hàng thực sự là tạo ra một nguồn lực mới. Vì thế:

POST /api/purchase

sẽ đặt hàng mới. Các chi tiết (người dùng, ô tô, v.v.) phải được tham chiếu bằng id (hoặc URI) bên trong nội dung được gửi đến địa chỉ này.

Không có vấn đề gì khi đặt mua một chiếc xe không chỉ là một INSERT đơn giản trong cơ sở dữ liệu. Trên thực tế, REST không phải là để hiển thị các bảng cơ sở dữ liệu của bạn dưới dạng các hoạt động CRUD. Từ quan điểm logic, bạn đang tạo một đơn đặt hàng (mua hàng), nhưng phía máy chủ có thể tự do thực hiện nhiều bước xử lý tùy thích.

Bạn thậm chí có thể lạm dụng giao thức HTTP hơn nữa. Sử dụng Locationtiêu đề để trả về liên kết đến đơn đặt hàng mới được tạo, cẩn thận chọn mã phản hồi HTTP để thông báo cho người dùng về sự cố (phía máy chủ hoặc phía máy khách), v.v.

Cách RESTful như tôi hiểu là bạn không cần các động từ HTTP mới, có một danh từ ở đâu đó sẽ có nghĩa là những gì bạn cần làm.

Mua một chiếc xe hơi? Chà không phải vậy

POST /api/order

Những gì bạn thực sự đang làm là tạo một đơn đặt hàng. Vì vậy, hãy thêm một tài nguyên khác để đặt hàng và đăng bài và đặt ở đó trong quá trình đặt hàng.

Hãy suy nghĩ về nguồn lực hơn là các cuộc gọi phương thức.

Để hoàn tất đơn đặt hàng, bạn có thể POST / api / order // hoàn thành hoặc thứ gì đó tương tự.

Tôi cảm thấy REST API giúp ích nhiều hơn theo nhiều cách hơn là chỉ cung cấp ngữ nghĩa. Vì vậy, không thể chọn kiểu RPC chỉ vì một số lời gọi dường như có ý nghĩa hơn trong kiểu hoạt động RPC. Ví dụ là api bản đồ google để tìm chỉ đường giữa hai địa điểm. Có vẻ như sau: http://maps.googleapis.com/maps/api/directions/json?origin=Jakkur&destination=Hebbal

Họ có thể gọi nó là "findDirections" (động từ) và coi nó như một phép toán. Thay vào đó, họ thực hiện "hướng" (danh từ) như một tài nguyên và coi việc tìm kiếm chỉ đường như một truy vấn về tài nguyên chỉ đường (Mặc dù trong nội bộ không thể có tài nguyên thực sự được gọi là hướng và nó có thể được thực hiện theo logic nghiệp vụ để tìm chỉ đường dựa trên các tham số).