rest api如何創(chuàng)建

資源創(chuàng)建是常見的REST API操作。 在這篇文章中，我們將看到如何創(chuàng)建單個資源。

客戶要求

通常，通過將POST請求發(fā)送到父集合資源來創(chuàng)建資源。 這將使用新生成的ID創(chuàng)建一個新的下屬資源。

例如，對/ projects的POST請求可用于在/ projects / 123處創(chuàng)建新的項目資源。

POST是冪等的，因此，如果多次發(fā)出同一請求，則可以創(chuàng)建多個資源。 （如果您不知道什么是冪等，請查看我有關(guān)冪等和安全的文章 ）。

在極少數(shù)情況下，如果客戶端能夠生成資源ID，則也有可能使用PUT進(jìn)行資源創(chuàng)建。 例如，在這種情況下，我們可以使用PUT / projects / <id>創(chuàng)建一個新項目。

客戶端還必須發(fā)送以下標(biāo)頭：

• 用于指定請求主體的媒體類型的Content-Type
• 接受以定義支持的響應(yīng)格式。 即使服務(wù)器不返回新創(chuàng)建的資源，也應(yīng)發(fā)送此標(biāo)頭。 如果資源創(chuàng)建失敗，它允許服務(wù)器發(fā)送詳細(xì)的錯誤信息。

范例要求

POST /projects Content-Type: application/json Accept: application/json { "name" : "My cool project" , "description" : "Bla bla .." }

服務(wù)器響應(yīng)

成功創(chuàng)建資源后，服務(wù)器應(yīng)使用HTTP 201（已創(chuàng)建）進(jìn)行響應(yīng)。 響應(yīng)還應(yīng)該具有一個Location標(biāo)頭，其中包含新創(chuàng)建的資源的URI。 需要時，響應(yīng)主體可以包含創(chuàng)建的資源。 在這種情況下，還需要Content-Type標(biāo)頭。

回應(yīng)范例

HTTP/ 1.1 201 Created Location: /projects/ 123 Content-Type: application/json { "id" : 123 , "name" : "My cool project" , "description" : "Bla bla .." }

翻譯自: https://www.javacodegeeks.com/2020/07/rest-creating-resources.html

rest api如何創(chuàng)建

總結(jié)

以上是生活随笔為你收集整理的rest api如何创建_REST：创建资源的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。