3 回答

TA貢獻1830條經(jīng)驗 獲得超3個贊
你所做的是正確的。通常,同一資源可能有許多URI - 沒有規(guī)則表明您不應(yīng)該這樣做。
通常,您可能需要直接訪問項目或作為其他內(nèi)容的子集 - 因此您的結(jié)構(gòu)對我來說很有意義。
僅僅因為員工可以在部門下訪問:
company/{companyid}/department/{departmentid}/employees
并不意味著他們也無法在公司下訪問:
company/{companyid}/employees
哪個會讓該公司的員工回歸。這取決于您的消費客戶需要什么 - 這就是您應(yīng)該設(shè)計的內(nèi)容。
但我希望所有URL處理程序使用相同的支持代碼來滿足請求,這樣您就不會復(fù)制代碼。

TA貢獻1824條經(jīng)驗 獲得超6個贊
我嘗試了兩種設(shè)計策略 - 嵌套和非嵌套端點。我發(fā)現(xiàn):
如果嵌套資源具有主鍵并且您沒有其主鍵,則嵌套結(jié)構(gòu)要求您獲取它,即使系統(tǒng)實際上并不需要它。
嵌套端點通常需要冗余端點。換句話說,您通常需要額外的/員工端點,以便獲得跨部門的員工列表。如果您有/員工,/公司/部門/員工到底會給您帶來什么?
嵌套端點不會很好地發(fā)展。例如,您現(xiàn)在可能不需要搜索員工,但您可能稍后會進行搜索,如果您有嵌套結(jié)構(gòu),則別無選擇,只能添加另一個端點。使用非嵌套設(shè)計,您只需添加更多參數(shù),這更簡單。
有時資源可能有多種類型的父母。導(dǎo)致多個端點都返回相同的資源。
冗余端點使得文檔更難編寫,也使得api更難學(xué)習(xí)。
簡而言之,非嵌套設(shè)計似乎允許更靈活和更簡單的端點模式。

TA貢獻1876條經(jīng)驗 獲得超7個贊
我把我從問題所做的事情轉(zhuǎn)移到了更多人可能會看到它的答案。
我所做的是在嵌套端點上創(chuàng)建創(chuàng)建端點,修改或查詢項目的規(guī)范端點不在嵌套資源上。
所以在這個例子中(只列出更改資源的端點)
POST
/companies/
創(chuàng)建新公司返回創(chuàng)建公司的鏈接。POST
/companies/{companyId}/departments
當(dāng)一個部門被放置創(chuàng)建新部門返回一個鏈接/departments/{departmentId}
PUT
/departments/{departmentId}
修改一個部門POST
/departments/{deparmentId}/employees
創(chuàng)建一個新員工返回一個鏈接/employees/{employeeId}
因此,每個集合都有根級資源。然而,創(chuàng)建是在擁有對象中。
添加回答
舉報