Theo Thông số HTTP / 1.1:

Các POSTphương pháp được sử dụng để yêu cầu rằng các máy chủ gốc chấp nhận các thực thể khép kín trong yêu cầu như một cấp dưới mới của tài nguyên được xác định bởi Request-URItrongRequest-Line

Nói cách khác, POSTđược sử dụng để tạo ra .

Các PUTyêu cầu phương pháp mà các thực thể kèm được lưu trữ dưới cung cấp Request-URI. Nếu tham chiếu Request-URIđến một tài nguyên đã tồn tại, thực thể kèm theo NÊN được coi là phiên bản sửa đổi của tài nguyên cư trú trên máy chủ gốc. Nếu Request-URIkhông trỏ đến một tài nguyên hiện có và URI đó có khả năng được xác định là tài nguyên mới bởi tác nhân người dùng yêu cầu, máy chủ gốc có thể tạo tài nguyên với URI đó. "

Đó là, PUTđược sử dụng để tạo hoặc thay thế .

Vì vậy, cái nào nên được sử dụng để tạo ra một tài nguyên? Hoặc một người cần phải hỗ trợ cả hai?

Nhìn chung:

Cả PUT và POST đều có thể được sử dụng để tạo.

Bạn phải hỏi "bạn đang thực hiện hành động để làm gì?" để phân biệt những gì bạn nên sử dụng. Giả sử bạn đang thiết kế một API để đặt câu hỏi. Nếu bạn muốn sử dụng POST thì bạn sẽ làm điều đó với một danh sách các câu hỏi. Nếu bạn muốn sử dụng PUT thì bạn sẽ làm điều đó cho một câu hỏi cụ thể.

Cả hai đều có thể được sử dụng, vì vậy tôi nên sử dụng cái nào trong thiết kế RESTful của mình:

Bạn không cần phải hỗ trợ cả PUT và POST.

Mà được sử dụng là tùy thuộc vào bạn. Nhưng chỉ cần nhớ sử dụng đúng tùy thuộc vào đối tượng bạn đang tham chiếu trong yêu cầu.

Một số cân nhắc:

• Bạn có đặt tên rõ ràng cho các đối tượng URL mà bạn tạo hoặc để máy chủ quyết định không? Nếu bạn đặt tên cho chúng thì hãy sử dụng PUT. Nếu bạn để máy chủ quyết định thì hãy sử dụng POST.
• PUT là idempotent, vì vậy nếu bạn PUT một đối tượng hai lần, nó không có hiệu lực. Đây là một tài sản tốt, vì vậy tôi sẽ sử dụng PUT khi có thể.
• Bạn có thể cập nhật hoặc tạo tài nguyên bằng PUT với cùng một URL đối tượng
• Với POST, bạn có thể có 2 yêu cầu đến cùng lúc thực hiện sửa đổi cho một URL và chúng có thể cập nhật các phần khác nhau của đối tượng.

Một ví dụ:

Tôi đã viết như sau như một phần của câu trả lời khác về SO về điều này :

BÀI ĐĂNG:

Được sử dụng để sửa đổi và cập nhật tài nguyên

POST /questions/<existing_question> HTTP/1.1
Host: www.example.com/

Lưu ý rằng sau đây là một lỗi:

POST /questions/<new_question> HTTP/1.1
Host: www.example.com/

Nếu URL chưa được tạo, bạn không nên sử dụng POST để tạo URL trong khi chỉ định tên. Điều này sẽ dẫn đến lỗi 'không tìm thấy tài nguyên' vì <new_question>chưa tồn tại. Bạn nên PUT <new_question> tài nguyên trên máy chủ trước.

Mặc dù bạn có thể làm một cái gì đó như thế này để tạo tài nguyên bằng POST:

POST /questions HTTP/1.1
Host: www.example.com/

Lưu ý rằng trong trường hợp này tên tài nguyên không được chỉ định, đường dẫn URL của đối tượng mới sẽ được trả về cho bạn.

ĐẶT:

Được sử dụng để tạo một tài nguyên, hoặc ghi đè lên nó. Trong khi bạn chỉ định tài nguyên URL mới.

Đối với tài nguyên mới:

PUT /questions/<new_question> HTTP/1.1
Host: www.example.com/

Để ghi đè một tài nguyên hiện có:

PUT /questions/<existing_question> HTTP/1.1
Host: www.example.com/

Ngoài ra, và chính xác hơn một chút, RFC 7231 Mục 4.3.4 trạng thái PUT (nhấn mạnh thêm),

4.3.4. ĐẶT

Phương thức PUT yêu cầu trạng thái của tài nguyên đích phải createdhoặc replacedvới trạng thái được xác định bởi biểu diễn kèm theo trong tải trọng thông báo yêu cầu.

Bạn có thể tìm thấy các xác nhận trên web cho biết

• POST nên được sử dụng để tạo tài nguyên và PUT nên được sử dụng để sửa đổi một tài nguyên
• PUT nên được sử dụng để tạo tài nguyên và POST nên được sử dụng để sửa đổi một tài nguyên

Không phải là hoàn toàn đúng.

Tốt hơn là chọn giữa PUT và POST dựa trên tính không thay đổi của hành động.

PUT ngụ ý đặt một tài nguyên - thay thế hoàn toàn bất cứ thứ gì có sẵn tại URL đã cho bằng một thứ khác. Theo định nghĩa, PUT là idempotent. Làm điều đó nhiều lần như bạn muốn, và kết quả là như nhau.x=5là bình thường. Bạn có thể PUT một tài nguyên cho dù trước đó nó có tồn tại hay không (ví dụ: để Tạo hoặc Cập nhật)!

POST cập nhật tài nguyên, thêm tài nguyên phụ hoặc gây ra thay đổi. POST không phải là idempotent, theo cách x++không phải là idempotent.

Theo lập luận này, PUT là để tạo khi bạn biết URL của thứ bạn sẽ tạo. POST có thể được sử dụng để tạo khi bạn biết URL của "nhà máy" hoặc người quản lý cho danh mục những thứ bạn muốn tạo.

vì thế:

POST /expense-report

hoặc là:

PUT  /expense-report/10929

• POST vào URL tạo tài nguyên con tại URL do máy chủ xác định .
• PUT cho một URL tạo / thay thế toàn bộ tài nguyên tại URL do khách hàng xác định .
• VĂN tới một URL cập nhật một phần tài nguyên tại URL do khách hàng đó xác định.

Thông số kỹ thuật có liên quan cho PUT và POST là RFC 2616 §9.5ff.

POST tạo một tài nguyên con , vì vậy POST để /itemstạo một tài nguyên nằm dưới /itemstài nguyên đó. Ví dụ. /items/1. Gửi cùng một gói bài hai lần sẽ tạo ra hai tài nguyên.

PUT là để tạo hoặc thay thế tài nguyên tại một URL được khách hàng biết đến .

Do đó: PUT chỉ là ứng cử viên cho TẠO nơi khách hàng đã biết url trước khi tài nguyên được tạo. Ví dụ. /blogs/nigel/entry/when_to_use_post_vs_putnhư tiêu đề được sử dụng làm khóa tài nguyên

PUT thay thế tài nguyên tại url đã biết nếu nó đã tồn tại, do đó, việc gửi cùng một yêu cầu hai lần không có hiệu lực. Nói cách khác, các cuộc gọi đến PUT là tạm thời .

RFC đọc như thế này:

Sự khác biệt cơ bản giữa các yêu cầu POST và PUT được phản ánh theo nghĩa khác nhau của URI yêu cầu. URI trong yêu cầu POST xác định tài nguyên sẽ xử lý thực thể kèm theo. Tài nguyên đó có thể là một quá trình chấp nhận dữ liệu, một cổng vào một số giao thức khác hoặc một thực thể riêng biệt chấp nhận các chú thích. Ngược lại, URI trong yêu cầu PUT xác định thực thể kèm theo yêu cầu - tác nhân người dùng biết URI dự định là gì và máy chủ KHÔNG cố gắng áp dụng yêu cầu cho một số tài nguyên khác. Nếu máy chủ mong muốn rằng yêu cầu được áp dụng cho một URI khác,

Lưu ý: PUT chủ yếu được sử dụng để cập nhật tài nguyên (bằng cách thay thế toàn bộ tài nguyên), nhưng gần đây có xu hướng sử dụng PATCH để cập nhật tài nguyên hiện có, vì PUT chỉ định rằng nó thay thế toàn bộ tài nguyên. RFC 5789.

Cập nhật 2018 : Có một trường hợp có thể được thực hiện để tránh PUT. Xem "REST không PUT"

Với hệ thống REST REST không có kỹ thuật PUT, ý tưởng là người tiêu dùng buộc phải đăng tài nguyên yêu cầu 'danh từ' mới. Như đã thảo luận trước đó, việc thay đổi địa chỉ gửi thư của khách hàng là POST thành tài nguyên mới ChangeOfAddress, chứ không phải là PUT của tài nguyên khách hàng trên mạng với giá trị trường địa chỉ gửi thư khác.

lấy từ Thiết kế API REST - Mô hình hóa tài nguyên bởi Prakash Subramaniam của Th Thinkworks

Điều này buộc API phải tránh các vấn đề chuyển trạng thái với nhiều khách hàng đang cập nhật một tài nguyên và phù hợp hơn với nguồn cung cấp sự kiện và CQRS. Khi công việc được thực hiện không đồng bộ, BÀI ĐĂNG chuyển đổi và chờ đợi nó được áp dụng có vẻ phù hợp.

Tóm lược:

Tạo nên:

Có thể được thực hiện với cả PUT hoặc POST theo cách sau:

ĐẶT

Tạo THE tài nguyên mới với newResourceId như nhận diện, dưới sự tài / URI, hoặc bộ sưu tập .

PUT /resources/<newResourceId> HTTP/1.1 

BÀI ĐĂNG

Tạo Một tài nguyên mới dưới các nguồn lực / URI, hoặc bộ sưu tập . Thông thường định danh được trả về bởi máy chủ.

POST /resources HTTP/1.1

Cập nhật:

Có thể chỉ được thực hiện với PUT theo cách sau:

ĐẶT

Cập nhật tài nguyên với currentResourceId làm định danh, dưới / URI tài nguyên hoặc bộ sưu tập .

PUT /resources/<existingResourceId> HTTP/1.1

Giải trình:

Khi giao dịch với REST và URI là chung, bạn có chung ở bên trái và cụ thể ở bên phải . Các tổng quát thường được gọi là các bộ sưu tập và các mục cụ thể hơn có thể được gọi là tài nguyên . Lưu ý rằng một tài nguyên có thể chứa một bộ sưu tập .

Ví dụ:

<- chung chung - cụ thể ->

URI: website.com/users/john
website.com  - whole site
users        - collection of users
john         - item of the collection, or a resource

URI:website.com/users/john/posts/23
website.com  - whole site
users        - collection of users
john         - item of the collection, or a resource
posts        - collection of posts from john
23           - post from john with identifier 23, also a resource

Khi bạn sử dụng POST, bạn luôn tham chiếu đến một bộ sưu tập , vì vậy bất cứ khi nào bạn nói:

POST /users HTTP/1.1

bạn đang đăng một người dùng mới vào bộ sưu tập người dùng .

Nếu bạn tiếp tục và thử một cái gì đó như thế này:

POST /users/john HTTP/1.1

nó sẽ hoạt động, nhưng về mặt ngữ nghĩa, bạn đang nói rằng bạn muốn thêm tài nguyên vào bộ sưu tập john trong bộ sưu tập người dùng .

Khi bạn đang sử dụng PUT, bạn đang tham chiếu đến một tài nguyên hoặc một mục duy nhất, có thể bên trong một bộ sưu tập . Vì vậy, khi bạn nói:

PUT /users/john HTTP/1.1

bạn đang nói với bản cập nhật máy chủ hoặc tạo nếu nó không tồn tại, tài nguyên john trong bộ sưu tập người dùng .

Thông số:

Hãy để tôi nhấn mạnh một số phần quan trọng của thông số kỹ thuật:

BÀI ĐĂNG

Các POST phương pháp được sử dụng để yêu cầu rằng các máy chủ gốc chấp nhận các thực thể khép kín trong yêu cầu như một mới cấp dưới của tài nguyên được xác định bởi Yêu cầu-URI trong Request-Line

Do đó, tạo ra một tài nguyên mới trên một bộ sưu tập .

ĐẶT

Các PUT yêu cầu phương pháp mà các thực thể kèm được lưu trữ dưới đã cung cấp Yêu cầu-URI. Nếu URI yêu cầu đề cập đến một tài nguyên đã tồn tại , thực thể kèm theo NÊN được coi là phiên bản sửa đổi của tài nguyên cư trú trên máy chủ gốc. Nếu URI yêu cầu không trỏ đến tài nguyên hiện có và URI đó có khả năng được xác định là tài nguyên mới bởi tác nhân người dùng yêu cầu, máy chủ gốc có thể tạo tài nguyên với URI đó. "

Do đó, tạo hoặc cập nhật dựa trên sự tồn tại của tài nguyên .

Tài liệu tham khảo:

• Thông số HTTP / 1.1
• Wikipedia - REST
• Mã định danh tài nguyên đồng nhất (URI): Cú pháp chung và ngữ nghĩa

POST có nghĩa là "tạo mới" như trong "Đây là đầu vào để tạo người dùng, tạo nó cho tôi".

PUT có nghĩa là "chèn, thay thế nếu đã tồn tại" như trong "Đây là dữ liệu cho người dùng 5".

Bạn POSTđến example.com/users vì bạn chưa biết URLngười dùng, bạn muốn máy chủ tạo nó.

Bạn PUTvào example.com/users/id vì bạn muốn thay thế / tạo một người dùng cụ thể .

Đăng hai lần với cùng một dữ liệu có nghĩa là tạo hai người dùng giống hệt nhau với các id khác nhau. PUT hai lần với cùng một dữ liệu sẽ tạo cho người dùng lần đầu tiên và cập nhật anh ta về cùng trạng thái lần thứ hai (không thay đổi). Vì bạn kết thúc với cùng một trạng thái sau khi PUTbạn thực hiện nó bao nhiêu lần, nó được cho là "mạnh như nhau" mỗi lần - bình thường. Điều này rất hữu ích để tự động thử lại các yêu cầu. Không còn nữa "bạn có chắc chắn muốn gửi lại" khi bạn nhấn nút quay lại trên trình duyệt.

Một lời khuyên chung là sử dụng POSTkhi bạn cần máy chủ kiểm soát việc URLtạo tài nguyên của bạn. Sử dụng PUTkhác. Thích PUT hơn POST.

Tôi muốn thêm lời khuyên "thực dụng" của tôi. Sử dụng PUT khi bạn biết "id" mà đối tượng bạn đang lưu có thể được truy xuất. Sử dụng PUT sẽ không hoạt động tốt nếu bạn cần, ví dụ, một id cơ sở dữ liệu được tạo sẽ được trả về để bạn thực hiện tra cứu hoặc cập nhật trong tương lai.

Vì vậy: Để lưu người dùng hiện tại hoặc người dùng nơi khách hàng tạo id và được xác minh rằng id là duy nhất:

PUT /user/12345 HTTP/1.1  <-- create the user providing the id 12345
Host: mydomain.com

GET /user/12345 HTTP/1.1  <-- return that user
Host: mydomain.com

Mặt khác, sử dụng POST để tạo đối tượng ban đầu và PUT để cập nhật đối tượng:

POST /user HTTP/1.1   <--- create the user, server returns 12345
Host: mydomain.com

PUT /user/12345 HTTP/1.1  <--- update the user
Host: mydomain.com

Sử dụng POST để tạo và PUT để cập nhật. Dù sao đó cũng là cách Ruby on Rails làm việc đó.

PUT    /items/1      #=> update
POST   /items        #=> create

Cả hai đều được sử dụng để truyền dữ liệu giữa máy khách đến máy chủ, nhưng có sự khác biệt tinh tế giữa chúng, đó là:

Sự giống nhau:

• PUT tức là lấy và đặt nó ở đâu.
• POST như gửi mail trong bưu điện.

Truyền thông xã hội / Mạng tương tự:

• Đăng trên phương tiện truyền thông xã hội: khi chúng tôi đăng tin nhắn, nó tạo ra bài viết mới.
• Đặt (tức là chỉnh sửa) cho tin nhắn chúng tôi đã đăng.

REST rất khái niệm cao cấp. Trên thực tế, nó thậm chí không đề cập đến HTTP!

Nếu bạn có bất kỳ nghi ngờ nào về cách triển khai REST trong HTTP, bạn luôn có thể xem Giao thức xuất bản nguyên tử (AtomPub) thông số kỹ thuật của . AtomPub là một tiêu chuẩn để viết các dịch vụ web RESTful với HTTP được phát triển bởi nhiều bộ phát sáng HTTP và REST, với một số đầu vào từ Roy Fielding, nhà phát minh của REST và (đồng phát minh ra HTTP).

Trên thực tế, bạn thậm chí có thể sử dụng trực tiếp AtomPub. Mặc dù nó ra khỏi cộng đồng viết blog, nhưng nó không bị hạn chế trong việc viết blog: đó là một giao thức chung để tương tác RESTly với các bộ sưu tập tài nguyên tùy ý (lồng nhau) thông qua HTTP. Nếu bạn có thể biểu diễn ứng dụng của mình dưới dạng tập hợp các tài nguyên lồng nhau, thì bạn chỉ cần sử dụng AtomPub và không cần lo lắng về việc nên sử dụng PUT hay POST, Mã trạng thái HTTP nào sẽ trả về và tất cả các chi tiết đó.

Đây là những gì AtomPub nói về việc tạo tài nguyên (phần 9.2):

Để thêm thành viên vào Bộ sưu tập, khách hàng gửi yêu cầu POST đến URI của Bộ sưu tập.

Quyết định về việc sử dụng PUT hay POST để tạo tài nguyên trên máy chủ có API HTTP + REST dựa trên người sở hữu cấu trúc URL. Để khách hàng biết hoặc tham gia vào việc xác định, cấu trúc URL là một khớp nối không cần thiết gần giống với các khớp nối không mong muốn phát sinh từ SOA. Thoát khỏi các loại khớp nối là lý do REST rất phổ biến. Do đó, phương pháp thích hợp để sử dụng là POST. Có các ngoại lệ cho quy tắc này và chúng xảy ra khi khách hàng muốn duy trì quyền kiểm soát cấu trúc vị trí của các tài nguyên mà nó triển khai. Điều này là hiếm và có khả năng có nghĩa là một cái gì đó khác là sai.

Tại thời điểm này, một số người sẽ lập luận rằng nếu sử dụng URL RESTful , khách hàng sẽ biết URL của tài nguyên và do đó PUT được chấp nhận. Rốt cuộc, đây là lý do tại sao các URL chính thức, bình thường hóa, Ruby on Rails, Django rất quan trọng, hãy nhìn vào API API API blah blah blah. Những người đó cần phải hiểu rằng không có thứ gì gọi là Restful-URL và chính Roy Fielding nói rằng :

API REST không được xác định tên tài nguyên hoặc cấu trúc phân cấp cố định (khớp nối rõ ràng giữa máy khách và máy chủ). Máy chủ phải có quyền tự do kiểm soát không gian tên của chính họ. Thay vào đó, cho phép các máy chủ hướng dẫn khách hàng cách xây dựng các URI phù hợp, chẳng hạn như được thực hiện trong các biểu mẫu HTML và mẫu URI, bằng cách xác định các hướng dẫn đó trong các loại phương tiện và quan hệ liên kết. [Thất bại ở đây ngụ ý rằng các máy khách đang giả định cấu trúc tài nguyên do thông tin ngoài băng, chẳng hạn như tiêu chuẩn dành riêng cho miền, là hướng dữ liệu tương đương với khớp nối chức năng của RPC].

http://roy.gbiv.com/untangled/2008/rest-apis-must-be-hypertext-driven

Ý tưởng về RESTful-URL thực sự là vi phạm REST vì máy chủ chịu trách nhiệm về cấu trúc URL và được tự do quyết định cách sử dụng nó để tránh ghép nối. Nếu điều này làm bạn bối rối, bạn sẽ đọc về tầm quan trọng của việc tự khám phá về thiết kế API.

Sử dụng POST để tạo tài nguyên đi kèm với việc xem xét thiết kế vì POST không phải là idempotent. Điều này có nghĩa là việc lặp lại POST nhiều lần không đảm bảo cùng một hành vi mỗi lần. Điều này khiến mọi người sợ sử dụng PUT để tạo tài nguyên khi họ không nên.Họ biết điều đó sai (POST là dành cho TẠO) nhưng dù sao họ cũng làm điều đó vì họ không biết cách giải quyết vấn đề này. Mối quan tâm này được thể hiện trong tình huống sau:

1. Máy khách POST một tài nguyên mới cho máy chủ.
2. Máy chủ xử lý yêu cầu và gửi phản hồi.
3. Khách hàng không bao giờ nhận được phản hồi.
4. Máy chủ không biết khách hàng chưa nhận được phản hồi.
5. Máy khách không có URL cho tài nguyên (do đó PUT không phải là một tùy chọn) và lặp lại POST.
6. POST không phải là idempotent và máy chủ

Bước 6 là nơi mọi người thường bối rối về những việc cần làm. Tuy nhiên, không có lý do gì để tạo ra một loại bùn để giải quyết vấn đề này. Thay vào đó, HTTP có thể được sử dụng như được chỉ định trong RFC 2616 và máy chủ trả lời:

10,4.10 409 Xung đột

Yêu cầu không thể được hoàn thành do xung đột với trạng thái hiện tại của tài nguyên. Mã này chỉ được phép trong các tình huống mà người dùng dự kiến ​​có thể giải quyết xung đột và gửi lại yêu cầu. Cơ quan phản hồi NÊN bao gồm đủ

thông tin để người dùng nhận ra nguồn gốc của xung đột. Lý tưởng nhất, thực thể phản hồi sẽ bao gồm đủ thông tin cho người dùng hoặc tác nhân người dùng để khắc phục sự cố; tuy nhiên, điều đó có thể là không thể và không bắt buộc.

Xung đột rất có thể xảy ra để đáp ứng yêu cầu PUT. Ví dụ: nếu phiên bản đang được sử dụng và thực thể là PUT bao gồm các thay đổi đối với tài nguyên xung đột với tài nguyên được tạo bởi yêu cầu trước đó (bên thứ ba), máy chủ có thể sử dụng phản hồi 409 để cho biết rằng nó không thể hoàn thành yêu cầu . Trong trường hợp này, thực thể phản hồi có thể sẽ chứa một danh sách các khác biệt giữa hai phiên bản theo định dạng được xác định bởi Kiểu nội dung phản hồi.

Trả lời với mã trạng thái 409 Xung đột là cách truy đòi đúng vì :

• Việc thực hiện POST dữ liệu có ID phù hợp với tài nguyên đã có trong hệ thống là một cuộc xung đột với trạng thái hiện tại của tài nguyên.
• Vì phần quan trọng là để khách hàng hiểu máy chủ có tài nguyên và thực hiện hành động thích hợp. Đây là một tình huống của người dùng, nơi người dùng dự kiến ​​có thể giải quyết xung đột và gửi lại yêu cầu.
• Phản hồi có chứa URL của tài nguyên với ID xung đột và các điều kiện tiên quyết thích hợp cho tài nguyên sẽ cung cấp đủ thông tin cho người dùng hoặc tác nhân người dùng để khắc phục sự cố, đây là trường hợp lý tưởng cho RFC 2616.

Cập nhật dựa trên việc phát hành RFC 7231 thành Thay thế 2616

RFC 7231 được thiết kế để thay thế 2616 và trong Phần 4.3.3 mô tả phản ứng có thể có sau cho POST

Nếu kết quả xử lý POST sẽ tương đương với đại diện của tài nguyên hiện có, máy chủ gốc có thể chuyển hướng tác nhân người dùng đến tài nguyên đó bằng cách gửi phản hồi 303 (Xem Khác) với mã định danh của tài nguyên hiện có trong trường Vị trí. Điều này có lợi ích là cung cấp cho tác nhân người dùng một mã định danh tài nguyên và chuyển biểu diễn thông qua một phương thức dễ sử dụng hơn vào bộ nhớ đệm được chia sẻ, mặc dù phải trả giá cho một yêu cầu bổ sung nếu tác nhân người dùng chưa có bộ đệm đại diện.

Bây giờ có thể chỉ đơn giản là trả về một số 303 trong trường hợp POST được lặp lại. Tuy nhiên, điều ngược lại là đúng. Trả lại một chiếc 303 sẽ chỉ có ý nghĩa nếu nhiều yêu cầu tạo (tạo các tài nguyên khác nhau) trả về cùng một nội dung. Một ví dụ sẽ là "cảm ơn bạn đã gửi tin nhắn yêu cầu của bạn" mà khách hàng không cần tải lại mỗi lần. RFC 7231 vẫn duy trì trong mục 4.2.2 rằng POST không phải là idempotent và tiếp tục duy trì POST nên được sử dụng để tạo.

Để biết thêm thông tin về điều này, đọc bài viết này .

Tôi thích lời khuyên này, từ định nghĩa PUT của RFC 2616 :

Sự khác biệt cơ bản giữa các yêu cầu POST và PUT được phản ánh theo nghĩa khác nhau của URI yêu cầu. URI trong yêu cầu POST xác định tài nguyên sẽ xử lý thực thể kèm theo. Tài nguyên đó có thể là một quá trình chấp nhận dữ liệu, một cổng vào một số giao thức khác hoặc một thực thể riêng biệt chấp nhận các chú thích. Ngược lại, URI trong yêu cầu PUT xác định thực thể kèm theo yêu cầu - tác nhân người dùng biết URI được dự định là gì và máy chủ KHÔNG cố gắng áp dụng yêu cầu cho một số tài nguyên khác.

Điều này phù hợp với lời khuyên khác ở đây, rằng PUT được áp dụng tốt nhất cho các tài nguyên đã có tên và POST rất tốt để tạo một đối tượng mới theo tài nguyên hiện có (và cho phép máy chủ đặt tên cho nó).

Tôi giải thích điều này và các yêu cầu về tính không thay đổi trên PUT, có nghĩa là:

• POST tốt cho việc tạo các đối tượng mới trong một bộ sưu tập (và việc tạo không cần phải là idempotent)
• PUT tốt cho việc cập nhật các đối tượng hiện có (và cập nhật cần phải bình thường)
• POST cũng có thể được sử dụng để cập nhật không bình thường cho các đối tượng hiện có (đặc biệt là thay đổi một phần của đối tượng mà không chỉ định toàn bộ - nếu bạn nghĩ về nó, việc tạo thành viên mới của bộ sưu tập thực sự là một trường hợp đặc biệt của loại này cập nhật, từ quan điểm của bộ sưu tập)
• PUT cũng có thể được sử dụng để tạo khi và chỉ khi bạn cho phép máy khách đặt tên tài nguyên. Nhưng vì các máy khách REST không cần phải đưa ra các giả định về cấu trúc URL, nên điều này ít hơn theo tinh thần dự định của mọi thứ.

Nói ngắn gọn:

PUT là idempotent, trong đó trạng thái tài nguyên sẽ giống nhau nếu cùng một hoạt động được thực hiện một lần hoặc nhiều lần.

POST không phải là idempotent, trong đó trạng thái tài nguyên có thể trở nên khác biệt nếu hoạt động được thực thi nhiều lần so với thực hiện một lần duy nhất.

Tương tự với truy vấn cơ sở dữ liệu

PUT Bạn có thể nghĩ tương tự như "CẬP NHẬT STUDENT SET address =" abc "trong đó id =" 123 ";

BÀI VIẾT Bạn có thể nghĩ về một cái gì đó như "XÁC NHẬN VÀO SINH VIÊN (tên, địa chỉ) GIÁ TRỊ (" abc "," xyzzz ");

Id sinh viên được tạo tự động.

Với PUT, nếu cùng một truy vấn được thực thi nhiều lần hoặc một lần, trạng thái bảng STUDENT vẫn giữ nguyên.

Trong trường hợp POST, nếu cùng một truy vấn được thực thi nhiều lần thì nhiều bản ghi Sinh viên sẽ được tạo trong cơ sở dữ liệu và trạng thái cơ sở dữ liệu thay đổi trên mỗi lần thực hiện truy vấn "INSERT".

LƯU Ý: PUT cần một vị trí tài nguyên (đã là tài nguyên) mà cập nhật cần phải xảy ra, trong khi POST không yêu cầu điều đó. Do đó, POST trực quan có nghĩa là để tạo ra một tài nguyên mới, trong khi PUT là cần thiết để cập nhật tài nguyên đã có.

Một số có thể đi kèm với các cập nhật có thể được thực hiện với POST. Không có quy tắc cứng nào nên sử dụng để cập nhật hoặc sử dụng quy tắc nào để tạo. Một lần nữa, đây là những quy ước, và theo trực giác, tôi nghiêng về lý luận đã đề cập ở trên và làm theo nó.

POST giống như đăng một bức thư vào hộp thư hoặc gửi email đến hàng đợi email. PUT giống như khi bạn đặt một vật thể vào lỗ hình khối hoặc một vị trí trên giá (nó có một địa chỉ đã biết).

Với POST, bạn đang đăng lên địa chỉ của QUEUE hoặc THU. Với PUT, bạn đang đặt địa chỉ của ITEM.

PUT là idempotent. Bạn có thể gửi yêu cầu 100 lần và nó sẽ không thành vấn đề. POST không phải là idempotent. Nếu bạn gửi yêu cầu 100 lần, bạn sẽ nhận được 100 email hoặc 100 chữ cái trong hộp thư của mình.

Một quy tắc chung: nếu bạn biết id hoặc tên của mặt hàng, hãy sử dụng PUT. Nếu bạn muốn id hoặc tên của mặt hàng được chỉ định bởi bên nhận, hãy sử dụng POST.

Câu trả lời mới (bây giờ tôi hiểu REST tốt hơn):

PUT chỉ đơn thuần là một tuyên bố về nội dung mà dịch vụ nên sử dụng, từ bây giờ, sử dụng để hiển thị các đại diện của tài nguyên được xác định bởi máy khách; POST là một tuyên bố về nội dung mà dịch vụ nên, kể từ bây giờ, chứa (có thể trùng lặp) nhưng tùy thuộc vào máy chủ cách xác định nội dung đó.

PUT x(nếu xxác định tài nguyên ): "Thay thế nội dung của tài nguyên được xác định bằng xnội dung của tôi."

PUT x(nếu xkhông xác định tài nguyên): "Tạo tài nguyên mới chứa nội dung của tôi và sử dụng xđể xác định tài nguyên đó."

POST x: "Lưu trữ nội dung của tôi và cung cấp cho tôi một mã định danh mà tôi có thể sử dụng để xác định tài nguyên (cũ hoặc mới) có chứa nội dung đã nói (có thể trộn lẫn với nội dung khác). Tài nguyên đã nói phải giống hệt hoặc phụ thuộc vào tài nguyên xnhận dạng." Thông thường " tài nguyên của y phụ thuộc vào tài nguyên của x " nhưng không nhất thiết phải được thực hiện bằng cách biến y thành một đường dẫn phụ của x (ví dụ x = /foovà y = /foo/bar) và sửa đổi (các) biểu diễn của tài nguyên x để phản ánh sự tồn tại của một tài nguyên mới, ví dụ như với một siêu liên kết đến yTài nguyên và một số siêu dữ liệu. Chỉ có cái sau mới thực sự cần thiết cho thiết kế tốt, vì URL mờ trong REST - bạn phải sử dụng hypermedia thay vì xây dựng URL phía máy khách để đi qua dịch vụ.

Trong REST, không có thứ gọi là tài nguyên chứa "nội dung". Tôi gọi là "nội dung" cho dữ liệu mà dịch vụ sử dụng để hiển thị các biểu diễn một cách nhất quán. Nó thường bao gồm một số hàng liên quan trong cơ sở dữ liệu hoặc tệp (ví dụ: tệp hình ảnh). Tùy thuộc vào dịch vụ để chuyển đổi nội dung của người dùng thành thứ mà dịch vụ có thể sử dụng, ví dụ: chuyển đổi tải trọng JSON thành các câu lệnh SQL.

Câu trả lời gốc (có thể dễ đọc hơn) :

PUT /something(nếu /somethingđã tồn tại): "Lấy bất cứ thứ gì bạn có /somethingvà thay thế nó bằng những gì tôi đưa cho bạn."

PUT /something(nếu /somethingchưa tồn tại): "Lấy những gì tôi đưa cho bạn và đặt nó vào /something."

POST /something: "Lấy những gì tôi đưa cho bạn và đặt nó ở bất cứ đâu bạn muốn /somethingmiễn là bạn đưa cho tôi URL của nó khi bạn hoàn thành."

Câu trả lời ngắn:

Quy tắc đơn giản: Sử dụng POST để tạo, sử dụng PUT để cập nhật.

Câu trả lời dài:

BÀI ĐĂNG:

• POST được sử dụng để gửi dữ liệu đến máy chủ.
• Hữu ích khi không xác định được URL của tài nguyên

ĐẶT:

• PUT được sử dụng để chuyển trạng thái đến máy chủ
• Hữu ích khi biết URL của tài nguyên

Trả lời dài hơn:

Để hiểu nó, chúng ta cần đặt câu hỏi tại sao PUT lại được yêu cầu, những vấn đề mà PUT đang cố gắng giải quyết là POST không thể.

Từ quan điểm của kiến ​​trúc REST, không có vấn đề gì. Chúng tôi có thể sống mà không có PUT. Nhưng theo quan điểm của một nhà phát triển khách hàng, nó làm cho cuộc sống của anh ấy / cô ấy đơn giản hơn rất nhiều.

Trước PUT, khách hàng không thể trực tiếp biết URL mà máy chủ đã tạo hoặc nếu tất cả đã tạo bất kỳ hoặc liệu dữ liệu được gửi đến máy chủ đã được cập nhật hay chưa. PUT làm giảm các nhà phát triển của tất cả những đau đầu. PUT là idempotent, PUT xử lý các điều kiện cuộc đua và PUT cho phép khách hàng chọn URL.

Ruby on Rails 4.0 sẽ sử dụng phương thức 'PATCH' thay vì PUT để cập nhật một phần.

RFC 5789 nói về PATCH (từ năm 1995):

Một phương pháp mới là cần thiết để cải thiện khả năng tương tác và ngăn ngừa lỗi. Phương thức PUT đã được xác định để ghi đè lên tài nguyên với phần thân hoàn toàn mới và không thể được sử dụng lại để thực hiện các thay đổi một phần. Mặt khác, proxy và bộ nhớ cache, và thậm chí cả máy khách và máy chủ, có thể bị nhầm lẫn về kết quả của hoạt động. POST đã được sử dụng nhưng không có khả năng tương tác rộng (đối với một, không có cách tiêu chuẩn nào để khám phá hỗ trợ định dạng bản vá). PATCH đã được đề cập trong các thông số kỹ thuật HTTP trước đó, nhưng không được xác định hoàn toàn.

" Edge Rails: PATCH là phương thức HTTP chính mới để cập nhật " giải thích nó.

Có nguy cơ khôi phục lại những gì đã được nói, có vẻ quan trọng cần nhớ rằng PUT ngụ ý rằng máy khách kiểm soát những gì URL sẽ kết thúc khi tạo tài nguyên. Vì vậy, một phần của sự lựa chọn giữa PUT và POST sẽ là về mức độ bạn có thể tin tưởng khách hàng để cung cấp URL chính xác, chuẩn hóa phù hợp với bất kỳ lược đồ URL nào của bạn.

Khi bạn không thể hoàn toàn tin tưởng khách hàng thực hiện đúng, sẽ phù hợp hơn khi sử dụng POST để tạo một mục mới và sau đó gửi URL lại cho khách hàng trong phản hồi.

Nói một cách rất đơn giản, tôi lấy ví dụ về dòng thời gian của Facebook.

Trường hợp 1: Khi bạn đăng một cái gì đó lên dòng thời gian của mình, đó là một mục mới. Vì vậy, trong trường hợp này, họ sử dụng phương thức POST vì phương thức POST không phải là idempotent.

Trường hợp 2: Nếu bạn của bạn nhận xét về bài đăng của bạn lần đầu tiên, điều đó cũng sẽ tạo ra một mục mới trong cơ sở dữ liệu để phương thức POST được sử dụng.

Trường hợp 3: Nếu bạn của bạn chỉnh sửa nhận xét của mình, trong trường hợp này, họ đã có id nhận xét, vì vậy họ sẽ cập nhật nhận xét hiện có thay vì tạo một mục mới trong cơ sở dữ liệu. Do đó, đối với loại hoạt động này, hãy sử dụng phương thức PUT vì nó là idempotent. *

Trong một dòng duy nhất, sử dụng POST để thêm một mục mới trong cơ sở dữ liệu và PUT để cập nhật một cái gì đó trong cơ sở dữ liệu.

Việc xem xét quan trọng nhất là độ tin cậy . Nếu một tin nhắn POST bị mất, trạng thái của hệ thống không được xác định. Tự động phục hồi là không thể. Đối với các thông báo PUT, trạng thái chỉ được xác định cho đến khi thử lại thành công đầu tiên.

Ví dụ, có thể không phải là một ý tưởng tốt để tạo giao dịch thẻ tín dụng với POST.

Nếu bạn tình cờ có URI tự động tạo trên tài nguyên của mình, bạn vẫn có thể sử dụng PUT bằng cách chuyển URI được tạo (trỏ đến tài nguyên trống) cho máy khách.

Một số cân nhắc khác:

• POST không hợp lệ các bản sao được lưu trong bộ nhớ cache của toàn bộ tài nguyên chứa (tính nhất quán tốt hơn)
• Phản hồi PUT không được lưu trong bộ nhớ cache trong khi các phản hồi POST là (Yêu cầu vị trí nội dung và hết hạn)
• PUT ít được hỗ trợ bởi ví dụ Java ME, các trình duyệt cũ hơn, tường lửa

Những độc giả mới tham gia chủ đề này sẽ bị ấn tượng bởi cuộc thảo luận bất tận về những gì bạn nên làm và sự vắng mặt tương đối của các bài học từ kinh nghiệm. Thực tế là REST được "ưu tiên" hơn SOAP, tôi cho rằng, việc học hỏi kinh nghiệm ở cấp độ cao, nhưng lòng tốt chúng ta có phải đã tiến bộ từ đó không? Đó là năm 2016. Luận án của Roy là vào năm 2000. Chúng ta đã phát triển những gì? Có vui không? Có dễ dàng để tích hợp với? Hỗ trợ? Nó sẽ xử lý sự gia tăng của điện thoại thông minh và kết nối di động không ổn định?

Theo ME, mạng thực tế là không đáng tin cậy. Yêu cầu thời gian chờ. Các kết nối được thiết lập lại. Mạng đi xuống hàng giờ hoặc nhiều ngày tại một thời điểm. Xe lửa đi vào đường hầm với người dùng di động trên tàu. Đối với bất kỳ yêu cầu nào (như thỉnh thoảng được thừa nhận trong tất cả các cuộc thảo luận này), yêu cầu có thể rơi xuống nước trên đường đi hoặc phản hồi có thể rơi xuống nước trên đường trở về. Trong các điều kiện này, việc đưa ra các yêu cầu PUT, POST và DELETE trực tiếp chống lại các tài nguyên thực sự luôn khiến tôi cảm thấy hơi tàn bạo và ngây thơ.

HTTP không làm gì để đảm bảo hoàn thành đáng tin cậy cho phản hồi yêu cầu và điều đó thật tốt vì đây là công việc của các ứng dụng nhận biết mạng. Phát triển một ứng dụng như vậy, bạn có thể chuyển qua các vòng để sử dụng PUT thay vì POST, sau đó nhiều vòng hơn để đưa ra một loại lỗi nhất định trên máy chủ nếu bạn phát hiện các yêu cầu trùng lặp. Quay lại máy khách, sau đó bạn phải nhảy qua các vòng để diễn giải các lỗi này, tải lại, xác nhận lại và đăng lại.

Hoặc bạn có thể làm điều này : coi các yêu cầu không an toàn của bạn là tài nguyên người dùng đơn lẻ phù hợp (hãy gọi chúng là hành động). Khách hàng yêu cầu một "hành động" mới trên một tài nguyên thực sự với một POST trống cho tài nguyên. POST sẽ chỉ được sử dụng cho việc này. Khi đã sở hữu URI một cách an toàn cho hành động mới được tạo ra, khách hàng PUT yêu cầu không an toàn đối với URI hành động, chứ không phải tài nguyên đích . Giải quyết hành động và cập nhật tài nguyên "thực" là công việc chính xác của API của bạn và ở đây được tách ra khỏi mạng không đáng tin cậy.

Máy chủ thực hiện công việc, trả về phản hồi và lưu trữ theo URI hành động đã thỏa thuận . Nếu có lỗi xảy ra, máy khách sẽ lặp lại yêu cầu (hành vi tự nhiên!) Và nếu máy chủ đã nhìn thấy nó, nó sẽ lặp lại phản hồi được lưu trữ và không làm gì khác .

Bạn sẽ nhanh chóng phát hiện ra sự tương đồng với những lời hứa: chúng tôi tạo và trả lại chỗ giữ chỗ cho kết quả trước khi làm bất cứ điều gì. Cũng giống như một lời hứa, một hành động có thể thành công hoặc thất bại một lần, nhưng kết quả của nó có thể được tìm nạp nhiều lần.

Trên hết, chúng tôi cho phép gửi và nhận ứng dụng một cơ hội để liên kết hành động được xác định duy nhất với tính duy nhất trong môi trường tương ứng của chúng. Và chúng tôi có thể bắt đầu yêu cầu và thực thi!, Hành vi có trách nhiệm từ khách hàng: lặp lại yêu cầu của bạn bao nhiêu tùy thích, nhưng đừng tạo ra một hành động mới cho đến khi bạn sở hữu kết quả dứt khoát từ kết quả hiện có.

Như vậy, nhiều vấn đề gai góc biến mất. Các yêu cầu chèn lặp đi lặp lại sẽ không tạo ra các bản sao và chúng tôi không tạo tài nguyên thực sự cho đến khi chúng tôi sở hữu dữ liệu. (các cột cơ sở dữ liệu có thể ở mức không rỗng). Yêu cầu cập nhật lặp lại sẽ không đạt trạng thái không tương thích và sẽ không ghi đè các thay đổi tiếp theo. Khách hàng có thể (tải lại) và xử lý liền mạch xác nhận ban đầu vì bất kỳ lý do gì (máy khách bị lỗi, phản hồi bị mất, v.v.).

Các yêu cầu xóa liên tiếp có thể xem và xử lý xác nhận ban đầu mà không gặp lỗi 404. Nếu mọi thứ mất nhiều thời gian hơn dự kiến, chúng tôi có thể trả lời tạm thời và chúng tôi có một nơi mà khách hàng có thể kiểm tra lại kết quả cuối cùng. Phần đẹp nhất của mẫu này là thuộc tính Kung-Fu (Panda). Chúng tôi có một điểm yếu, xu hướng để khách hàng lặp lại yêu cầu bất cứ khi nào họ không hiểu phản hồi và biến nó thành một điểm mạnh :-)

Trước khi nói với tôi đây không phải là RESTful, vui lòng xem xét nhiều cách mà các nguyên tắc REST được tôn trọng. Khách hàng không xây dựng URL. API vẫn có thể khám phá, mặc dù có một chút thay đổi về ngữ nghĩa. Động từ HTTP được sử dụng một cách thích hợp. Nếu bạn nghĩ rằng đây là một thay đổi lớn để thực hiện, tôi có thể nói với bạn từ kinh nghiệm rằng nó không phải.

Nếu bạn nghĩ rằng bạn sẽ có một lượng dữ liệu khổng lồ để lưu trữ, hãy nói về khối lượng: một xác nhận cập nhật điển hình là một phần của một kilobyte. HTTP hiện cung cấp cho bạn một hoặc hai phút để trả lời dứt khoát. Ngay cả khi bạn chỉ lưu trữ các hành động trong một tuần, khách hàng vẫn có nhiều cơ hội để bắt kịp. Nếu bạn có âm lượng rất lớn, bạn có thể muốn lưu trữ giá trị khóa tuân thủ axit chuyên dụng hoặc giải pháp trong bộ nhớ.

Ngoài những khác biệt được đề xuất bởi những người khác, tôi muốn thêm một.

Trong phương thức POST, bạn có thể gửi thông số cơ thể trongform-data

Trong phương thức PUT, bạn phải gửi thông số cơ thể trongx-www-form-urlencoded

Tiêu đề Content-Type:application/x-www-form-urlencoded

Theo đó, bạn không thể gửi tệp hoặc dữ liệu nhiều phần trong phương thức PUT

BIÊN TẬP

Loại nội dung "application / x-www-form-urlencoding" không hiệu quả để gửi số lượng lớn dữ liệu nhị phân hoặc văn bản có chứa các ký tự không phải ASCII. Loại nội dung "nhiều dữ liệu / biểu mẫu dữ liệu" nên được sử dụng để gửi biểu mẫu có chứa tệp, dữ liệu không phải ASCII và dữ liệu nhị phân.

Có nghĩa là nếu bạn phải nộp

các tệp, dữ liệu không phải ASCII và dữ liệu nhị phân

bạn nên sử dụng phương thức POST

Dường như luôn có một số nhầm lẫn về việc khi nào nên sử dụng HTTP POST so với phương thức HTTP PUT cho các dịch vụ REST. Hầu hết các nhà phát triển sẽ cố gắng liên kết các hoạt động CRUD trực tiếp với các phương thức HTTP. Tôi sẽ lập luận rằng điều này không đúng và người ta không thể đơn giản liên kết các khái niệm CRUD với các phương thức HTTP. Đó là:

Create => HTTP PUT
Retrieve => HTTP GET
Update => HTTP POST
Delete => HTTP DELETE

Đúng là R (etrieve) và D (elete) của các hoạt động CRUD có thể được ánh xạ trực tiếp tới các phương thức HTTP NHẬN và XÓA tương ứng. Tuy nhiên, sự nhầm lẫn nằm ở các hoạt động C (reate) và U (cập nhật). Trong một số trường hợp, người ta có thể sử dụng PUT để tạo trong khi trong các trường hợp khác, POST sẽ được yêu cầu. Sự không rõ ràng nằm trong định nghĩa của phương thức HTTP PUT so với phương thức POST HTTP.

Theo các thông số kỹ thuật HTTP 1.1, các phương thức GET, HEAD, DELETE và PUT phải là idempotent và phương thức POST không phải là idempotent. Điều đó có nghĩa là một hoạt động là bình thường nếu nó có thể được thực hiện trên một tài nguyên một lần hoặc nhiều lần và luôn trả về cùng một trạng thái của tài nguyên đó. Trong khi đó một hoạt động không bình thường có thể trả về trạng thái đã sửa đổi của tài nguyên từ yêu cầu này sang yêu cầu khác. Do đó, trong một hoạt động không bình thường, không có gì đảm bảo rằng người ta sẽ nhận được cùng một trạng thái của tài nguyên.

Dựa trên định nghĩa idempotent ở trên, tôi sử dụng phương thức HTTP PUT so với sử dụng phương thức POST HTTP cho các dịch vụ REST là: Sử dụng phương thức HTTP PUT khi:

The client includes all aspect of the resource including the unique identifier to uniquely identify the resource. Example: creating a new employee.
The client provides all the information for a resource to be able to modify that resource.This implies that the server side does not update any aspect of the resource (such as an update date).

Trong cả hai trường hợp, các thao tác này có thể được thực hiện nhiều lần với cùng kết quả. Đó là tài nguyên sẽ không được thay đổi bằng cách yêu cầu hoạt động nhiều lần. Do đó, một hoạt động bình thường thực sự. Sử dụng phương thức POST HTTP khi:

The server will provide some information concerning the newly created resource. For example, take a logging system. A new entry in the log will most likely have a numbering scheme which is determined on the server side. Upon creating a new log entry, the new sequence number will be determined by the server and not by the client.
On a modification of a resource, the server will provide such information as a resource state or an update date. Again in this case not all information was provided by the client and the resource will be changing from one modification request to the next. Hence a non idempotent operation.

Phần kết luận

Không tương quan trực tiếp và ánh xạ các hoạt động CRUD với các phương thức HTTP cho các dịch vụ REST. Việc sử dụng phương thức HTTP PUT so với phương thức HTTP POST phải dựa trên khía cạnh bình thường của hoạt động đó. Nghĩa là, nếu hoạt động là idempotent, thì hãy sử dụng phương thức HTTP PUT. Nếu hoạt động không bình thường, thì hãy sử dụng phương thức POST HTTP.

máy chủ gốc có thể tạo tài nguyên với URI đó

Vì vậy, bạn sử dụng POST và có thể, nhưng PUT không cần thiết cho việc tạo tài nguyên. Bạn không phải hỗ trợ cả hai. Đối với tôi POST là hoàn toàn đủ. Vì vậy, nó là một quyết định thiết kế.

Như trích dẫn của bạn đã đề cập, bạn sử dụng PUT để tạo không có tài nguyên nào được gán cho IRI và dù sao bạn cũng muốn tạo tài nguyên. Ví dụ: PUT /users/123/passwordthường thay thế mật khẩu cũ bằng mật khẩu mới, nhưng bạn có thể sử dụng nó để tạo mật khẩu nếu nó chưa tồn tại (ví dụ: bởi người dùng mới đăng ký hoặc khôi phục người dùng bị cấm).

Tôi sẽ hạ cánh với những điều sau đây:

PUT đề cập đến một tài nguyên, được xác định bởi URI. Trong trường hợp này, bạn đang cập nhật nó. Nó là một phần của ba động từ đề cập đến tài nguyên - xóa và trở thành hai động từ còn lại.

POST về cơ bản là một tin nhắn dạng tự do, với ý nghĩa của nó được xác định là 'ngoài băng'. Nếu tin nhắn có thể được hiểu là thêm tài nguyên vào một thư mục, điều đó sẽ ổn, nhưng về cơ bản, bạn cần hiểu thông điệp bạn đang gửi (đăng) để biết điều gì sẽ xảy ra với tài nguyên.

Bởi vì PUT và GET và DELETE đề cập đến một tài nguyên, chúng cũng theo định nghĩa idempotent.

POST có thể thực hiện ba chức năng khác, nhưng sau đó ngữ nghĩa của yêu cầu sẽ bị mất trên các trung gian như bộ nhớ cache và proxy. Điều này cũng áp dụng để cung cấp bảo mật cho tài nguyên, vì URI của bài đăng không nhất thiết chỉ ra tài nguyên mà nó đang áp dụng (mặc dù có thể).

Một PUT không cần phải là một sáng tạo; dịch vụ có thể lỗi nếu tài nguyên chưa được tạo, nhưng nếu không thì cập nhật nó. Hoặc ngược lại - nó có thể tạo tài nguyên, nhưng không cho phép cập nhật. Điều duy nhất cần có về PUT là nó trỏ đến một tài nguyên cụ thể và tải trọng của nó là sự thể hiện của tài nguyên đó. PUT thành công có nghĩa là (chặn nhiễu) rằng một GET sẽ lấy cùng một tài nguyên.

Chỉnh sửa: Một điều nữa - PUT có thể tạo, nhưng nếu có thì ID phải là ID tự nhiên - AKA là địa chỉ email. Theo cách đó, khi bạn PUT hai lần, lần đặt thứ hai là một bản cập nhật của lần đầu tiên. Điều này làm cho nó idempotent .

Nếu ID được tạo (ví dụ: ID nhân viên mới), thì PUT thứ hai có cùng URL sẽ tạo một bản ghi mới, vi phạm quy tắc tạm thời. Trong trường hợp này, động từ sẽ là POST và thông điệp (không phải tài nguyên) sẽ tạo ra một tài nguyên bằng cách sử dụng các giá trị được xác định trong thông báo này.

Các ngữ nghĩa được cho là khác nhau, trong đó "PUT", như "GET" được coi là không có nghĩa - nghĩa là bạn có thể yêu cầu PUT chính xác nhiều lần và kết quả sẽ như thể bạn chỉ thực hiện một lần.

Tôi sẽ mô tả các quy ước mà tôi nghĩ được sử dụng rộng rãi nhất và hữu ích nhất:

Khi bạn PUT một tài nguyên tại một URL cụ thể, điều đó xảy ra là nó sẽ được lưu tại URL đó hoặc một cái gì đó dọc theo các dòng đó.

Khi bạn POST vào một tài nguyên tại một URL cụ thể, thường thì bạn sẽ đăng một phần thông tin liên quan lên URL đó. Điều này ngụ ý rằng tài nguyên tại URL đã tồn tại.

Ví dụ: khi bạn muốn tạo một luồng mới, bạn có thể PUT nó với một số URL. Nhưng khi bạn muốn POST một tin nhắn đến một luồng hiện có, bạn POST vào URL của nó.

Đối với việc sửa đổi các thuộc tính của luồng, bạn có thể làm điều đó với PUT hoặc POST. Về cơ bản, chỉ sử dụng "PUT" khi hoạt động không hoạt động - nếu không thì sử dụng POST.

Tuy nhiên, lưu ý rằng không phải tất cả các trình duyệt hiện đại đều hỗ trợ các động từ HTTP ngoài GET hoặc POST.

Hầu hết thời gian, bạn sẽ sử dụng chúng như thế này:

• POST một tài nguyên vào một bộ sưu tập
• PUT một tài nguyên được xác định bởi bộ sưu tập /: id

Ví dụ:

• POST / mục
• PUT / vật phẩm / 1234

Trong cả hai trường hợp, phần thân yêu cầu chứa dữ liệu cho tài nguyên được tạo hoặc cập nhật. Rõ ràng từ tên tuyến đường rằng POST không phải là idempotent (nếu bạn gọi nó 3 lần thì nó sẽ tạo ra 3 đối tượng), nhưng PUT là idempotent (nếu bạn gọi nó là 3 lần thì kết quả là như nhau). PUT thường được sử dụng cho hoạt động "upsert" (tạo hoặc cập nhật), nhưng bạn luôn có thể trả về lỗi 404 nếu bạn chỉ muốn sử dụng nó để sửa đổi.

Lưu ý rằng POST "tạo" một phần tử mới trong bộ sưu tập và PUT "thay thế" một phần tử tại một URL nhất định, nhưng đó là một cách rất phổ biến để sử dụng PUT để sửa đổi một phần, nghĩa là chỉ sử dụng nó để cập nhật các tài nguyên hiện có và chỉ sửa đổi các trường được bao gồm trong cơ thể (bỏ qua các trường khác). Điều này là không chính xác về mặt kỹ thuật, nếu bạn muốn trở thành REST-purist, PUT nên thay thế toàn bộ tài nguyên và bạn nên sử dụng PATCH để cập nhật một phần. Cá nhân tôi không quan tâm nhiều đến hành vi rõ ràng và nhất quán trên tất cả các điểm cuối API của bạn.

Hãy nhớ rằng, REST là một tập hợp các quy ước và hướng dẫn để giữ cho API của bạn đơn giản. Nếu bạn kết thúc với một công việc phức tạp chỉ để kiểm tra hộp "RESTfull" thì bạn đang đánh bại mục đích;)

Mặc dù có thể có một cách bất khả tri để mô tả những điều này, nhưng nó dường như mâu thuẫn với các tuyên bố khác nhau từ câu trả lời cho các trang web.

Chúng ta hãy rất rõ ràng và trực tiếp ở đây. Nếu bạn là nhà phát triển .NET làm việc với API Web, thì thực tế là (từ tài liệu Microsoft API), http://www.asp.net/web-api/overview/creating-web-apis/creating-a-web -api-that-hỗ trợ-crud-hoạt động :

1. PUT = UPDATE (/api/products/id)
2. MCSD Exams 2014 -  UPDATE = PUT, there are **NO** multiple answers for that question period.

Chắc chắn bạn "có thể" sử dụng "POST" để cập nhật, nhưng chỉ cần tuân theo các quy ước được đặt ra cho bạn với khuôn khổ đã cho. Trong trường hợp của tôi, đó là .NET / Web API, vì vậy PUT dành cho CẬP NHẬT không có tranh luận.

Tôi hy vọng điều này sẽ giúp bất kỳ nhà phát triển nào của Microsoft đọc tất cả các nhận xét với các liên kết trang web của Amazon và Sun / Java.

Đây là một quy tắc đơn giản:

PUT cho một URL nên được sử dụng để cập nhật hoặc tạo tài nguyên có thể được đặt tại URL đó.

POST cho một URL nên được sử dụng để cập nhật hoặc tạo một tài nguyên được đặt tại một số URL ("cấp dưới") khác hoặc không thể định vị được qua HTTP.

Nếu bạn quen thuộc với các hoạt động cơ sở dữ liệu, có

1. Lựa chọn
2. Chèn
3. Cập nhật
4. Xóa bỏ
5. Hợp nhất (Cập nhật nếu đã có, chèn khác)

Tôi sử dụng PUTđể Hợp nhất và cập nhật như các hoạt động và sử dụng POSTcho Insertions.

Trong thực tế, POST hoạt động tốt để tạo tài nguyên. URL của tài nguyên mới được tạo phải được trả về trong tiêu đề phản hồi Vị trí. PUT nên được sử dụng để cập nhật tài nguyên hoàn toàn. Vui lòng hiểu rằng đây là những cách thực hành tốt nhất khi thiết kế API RESTful. Đặc tả HTTP như vậy không hạn chế sử dụng PUT / POST với một vài hạn chế để tạo / cập nhật tài nguyên. Hãy xem http://techoctave.com/c7/posts/71-twitter-rest-api-dissected để tóm tắt các thực tiễn tốt nhất.