Dịch vụ và hoạt động cập nhật RESTful

Question

Tôi biết REST có nghĩa là định hướng tài nguyên, điều này gần như chuyển thành các hoạt động CRUD trên các tài nguyên này bằng cách sử dụng các phương thức HTTP chuẩn. Nhưng những gì tôi chỉ muốn cập nhật một phần của tài nguyên?

Ví dụ: giả sử tôi có tài nguyên Payment và tôi muốn đánh dấu trạng thái của tài khoản là "paid". Tôi không muốn POST toàn bộ đối tượng Payment thông qua HTTP (đôi khi tôi thậm chí không có tất cả dữ liệu).

Cách nào để RESTful thực hiện điều này? I have seen that Twitter sử dụng các phương pháp sau đây cho updating Twitter statuses:

http://api.twitter.com/1/statuses/update.xml?status=playing with cURL and the Twitter API 

là phương pháp này trong "tinh thần" của REST?

CẬP NHẬT: PUT -> POST

Một số liên kết tôi tìm thấy trong khi chờ đợi:

• PUT or POST: The REST of the Story
• PUT is not UPDATE
• PATCH Method for HTTP

Answer 1

Cách lý tưởng để thực hiện việc này là thay đổi một phần (tài nguyên phụ) của tài nguyên và yêu cầu máy chủ trả lại 303 Xem khác với tiêu đề Vị trí để trỏ đến tài nguyên bị thay đổi. Các 303 Xem khác nói với khách hàng rằng kết quả của yêu cầu một số tài nguyên khác đã thay đổi và khách hàng nên cập nhật biểu diễn mà nó nắm giữ.

Trong ví dụ của bạn (loại phương tiện giả, tất nhiên):

 
1. Client retrieves payment representation 
GET /payments/2 

200 Ok 
Content-Type: application/payment+xml 

<payment> 
    <status href="/payments/2/status" value="pending"/> 
</payment> 

2. Client updates status 
PUT /payments/2/status 
Content-Type: text/plain 

payed 

303 See Other 
Location: /payments/2 

3. Client follows the 303 redirect 
GET /payments/2 

200 Ok 
Content-Type: application/payment+xml 

<payment> 
    <status href="/payments/2/status" value="payed"/> 
</payment> 

Answer 2

Tôi đoán, đó là những gì POST tôi s cho: 'U' trong 'CRUD'.

Bạn POST dữ liệu vào tài nguyên hiện có. Tài nguyên quyết định phải làm gì với nó và được cập nhật. Ngoài ra, dữ liệu POST có thể chỉ là một đoạn của tài nguyên hoàn chỉnh.

Cách tiếp cận của Twitter là IMHO không RESTful, vì chúng quá tải GET.

Answer 3

POST nên được sử dụng cho việc thay đổi một nguồn tài nguyên

EDIT: Bài viết của Martin Fowler Richardson Maturity Model là một giới thiệu rất tốt để nghỉ ngơi.

Answer 4

Có gì sai với PATCH? Vấn đề "sửa đổi một phần" dường như kêu gọi nó, đặc biệt là xem xét rằng đôi khi bạn không có tất cả các dữ liệu cần thiết để "thay thế" ... Nhưng thành thật mà nói, tôi không thấy điểm nào sau "POST = create, PUT = thay thế, PATCH = cập nhật "triết lý tôn giáo, và tôi thấy không có gì sai khi chỉ sử dụng POST.