路徑代理是一項強大的技術(shù)，它通過將用戶請求的真實路徑轉(zhuǎn)發(fā)到指定的代理URL，實現(xiàn)對請求的轉(zhuǎn)發(fā)和處理，并將處理后的請求結(jié)果返回給客戶端。本功能有助于統(tǒng)一資源管理，提高處理效率，滿足日益復(fù)雜的業(yè)務(wù)需求，適用于個性化品牌展示、跨平臺資源整合等需求場景。





什么是路徑代理？


將用戶請求的真實路徑轉(zhuǎn)發(fā)到指定的代理URL，從而實現(xiàn)對請求的轉(zhuǎn)發(fā)和處理，然后將處理后的請求結(jié)果返回給客戶端。如此可在不改變商城路徑的情況下，展示來自代理URL的內(nèi)容。


舉個例子，當(dāng)用戶在商城網(wǎng)站上點擊"About us"時，路徑代理可以將該請求轉(zhuǎn)發(fā)到公司官網(wǎng)介紹頁面或者Facebook主頁等，然后將相關(guān)內(nèi)容返回給用戶，同時保持商城路徑的不變性。這種擴展方式提供了更多與外部資源集成和互動的機會，為用戶帶來更多豐富多樣的內(nèi)容和功能體驗。


如何配置？

Step.01 填寫商城中已存在的真實路徑，注意真實路徑不能以斜杠（/）開頭，也不能包含問號（?）參數(shù)

Step.02 填寫要轉(zhuǎn)發(fā)至的代理URL，并了解我們的精準(zhǔn)匹配和泛匹配轉(zhuǎn)發(fā)效果，配置即可完成





效果示例一：在代理URL轉(zhuǎn)發(fā)請求時，會攜帶原始請求的子路徑和參數(shù)

配置真實路徑：apps/users

配置代理URL：https://example.com/proxy

原始請求路徑：apps/users/123?status=active

轉(zhuǎn)發(fā)后的請求路徑：https://example.com/proxy/users/123?status=active



效果示例二：如果原始請求和代理URL有相同的參數(shù)，則將使用原始請求中的參數(shù)值覆蓋代理URL

配置真實路徑：apps/orders

配置代理URL：https://example.com/api-proxy?status=completed

原始請求路徑：apps/orders/789?status=pending

轉(zhuǎn)發(fā)后的請求路徑：https://example.com/api-proxy/789?status=pending



工作原理



1. 確定源店鋪ID和當(dāng)前代理請求源端訪問域名，這些信息將用作header頭參數(shù)。



2. 獲取原始請求的子路徑和參數(shù)。這些信息將在轉(zhuǎn)發(fā)請求到代理URL時一并攜帶。



3. 檢查原始請求和代理URL是否具有相同的參數(shù)。如果存在相同的參數(shù)，需要使用原始請求中的參數(shù)值覆蓋代理URL中相應(yīng)參數(shù)的值。



4. 構(gòu)建轉(zhuǎn)發(fā)請求到代理URL的請求，包括以下內(nèi)容：
①根據(jù)實際需求選擇合適的HTTP或HTTPS協(xié)議。
②設(shè)置請求的目標(biāo)URL為代理URL。
③將原始請求的子路徑和參數(shù)添加到目標(biāo)URL中。
④檢查并處理相同參數(shù)的值覆蓋情況。
⑤添加特定的header頭參數(shù)到請求中，包括：

"x-oemcart-store-id"：設(shè)置為源店鋪ID。
"x-oemcart-current-domain"：設(shè)置為當(dāng)前代理請求源端訪問域名。



5. 發(fā)送轉(zhuǎn)發(fā)請求到代理URL，并等待響應(yīng)。



推薦使用場景



該功能適用于需要將特定請求從原始服務(wù)轉(zhuǎn)發(fā)到代理服務(wù)，并通過返回的HTML代碼將代理URL的內(nèi)容顯示給用戶的情況



特定的header頭參數(shù)可以用于在代理請求中傳遞額外的信息，例如源店鋪ID和當(dāng)前代理請求源端訪問域名



通過內(nèi)鏈頁面轉(zhuǎn)發(fā)進行個性化品牌展示、跨平臺資源整合。當(dāng)用戶點擊頁面內(nèi)鏈接或按鈕需要打開內(nèi)部指定頁面時,配置轉(zhuǎn)發(fā)規(guī)則將請求轉(zhuǎn)發(fā)到代理頁面實現(xiàn)。



注意事項

當(dāng)代理URL轉(zhuǎn)發(fā)請求時，會攜帶原始請求的子路徑、查詢參數(shù)和header頭參數(shù)。



代理請求支持GET、POST、DELETE、PUT等請求。



如果原始請求和代理URL具有相同的參數(shù)，代理URL將覆蓋使用原始請求的參數(shù)值。



真實路徑將進行泛匹配。例如，如果您填寫的真實路徑為"apps/products"，則"apps/products/123"、"apps/products/123/details"等都將成功匹配。



如果您設(shè)置了真實路徑"apps/products/123/details"和"apps/products"，則路徑更長的"apps/products/123/details"將優(yōu)先匹配，而不會走"apps/products"的代理轉(zhuǎn)發(fā)設(shè)置。

如果真實請求未命中任何代理規(guī)則，將會提示404頁面。