Dịch vụ REST - hiển thị các hành động không phải dữ liệu "

Question

Tôi hiểu cách sử dụng REST để thực hiện tương tác thực thể chung - sử dụng các tên url để ánh xạ tới thực thể và động từ HTTP để ánh xạ tới các hành động trên các thực thể đó. Nhưng cách nhìn chung được chấp nhận là nhìn vào "hành động" giống như RPC là gì?

Ví dụ: giả sử tôi muốn gửi lệnh cho thiết bị để đặt lại? Không có "thực thể" thực sự ở đây hoặc tôi làm một cái gì đó như POST tới http://mydevice/device/reset?

Answer 1

/device/reset hoặc /system/reset là ok.

phần còn lại "thiết kế mẫu" không khuyến khích bạn KHÔNG sử dụng bất kỳ động từ .. Bạn có thể làm:

POST http://mydevice/system/state  
<stateType>RESET</stateType> 

thông tin liên quan:

• How to create REST URL’s without verbs?
• Threads Tagged with restful-url

Answer 2

Tôi thường đặt tên cho thực thể là "hệ thống" hoặc đại loại như thế. Vì vậy, bạn làm "/ system/reset". Bạn đã chọn thiết bị để hoạt động quá.

Nhưng yea, tôi thường xem các loại hành động này là bản cập nhật, sẽ sử dụng phương thức POST. Vì vậy, tôi nghĩ bạn có quyền POST/device/reset

Answer 3

Tôi không nghĩ đó là trường hợp sử dụng POST. Các "hành động RESET" là một hành động idempotent (nếu bạn gọi nó là n lần bạn sẽ luôn luôn có được kết quả tương tự), vì vậy IMHO bạn nên sử dụng một cuộc gọi PUT thay vì POST (như POST không phải là idempotent).

Ngoài ra, như bạn đang Đưa một tài nguyên, bạn có thể sử dụng

PUT http://system 
<device> 
    <status>RESET</status> 
</device> 

hoặc

PUT http://system/status/reset 

Nhưng tôi nghĩ rằng một 1 là "ngon hơn", kể từ khi bạn đang đặt một tài nguyên, trong khi onde thứ hai bạn chỉ sử dụng url.