我可以在RESTful API中合併資源嗎？

Question

我的應用程序有「文件」，它們基本上只是圖像，而這些文件有「區域」。區域只是定義文檔上的x和y座標以繪製矩形並裁剪文檔。一個文件可以有很多區域。

由於區域完全依賴於文檔，因爲在沒有文檔的情況下它們不可能存在，我的端點是否會創建一個區域如下所示？

POST /documents/{document_id}/regions 

還是這樣？

POST /regions 

在第二種情況下，我必須通過JSON參數傳遞文檔ID。

Answer 1

第一個選項。作爲一般規則，只要通過在有效負載中傳遞一個ID而不是直接URI來與現有資源進行交互，那麼您正在執行RPC，而不是REST。