3 回答

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

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

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