一、背景介紹
在前后端分離項目開發中，前端頁面需要頻繁調用后端接口獲取數據。在高仙機器人對接項目中，我們采用了若依（RuoYi）框架，前端通過統一的 API 封裝與后端進行數據交互，而后端再對接高仙官方的 OPENAPI 實現數據獲取。這里梳理一下接口調用鏈路和關鍵點，作為開發經驗記錄。
二、前后端接口調用的鏈路
1. 前端請求（以獲取機器人地圖列表為例）
// src/api/gsrobot.js
export function getMapList(robotSn) {return request({url: '/external/gs/map/robotMap/list',method: 'post',data: { robotSn }})
}
前端只需要調用
/external/gs/map/robotMap/list這個約定好的 URL，無需關心數據來源細節。
2. 后端實現
后端監聽
/external/gs/map/robotMap/list，收到請求后，作為中間層調用高仙的 OPENAPI，獲取機器人地圖數據，并將數據轉為前端所需格式后返回。后端的這個 URL 是對外暴露的“數據入口”，前后端通過它達成約定。
3. 與高仙 OPENAPI 對接
后端通過 HTTP 客戶端調用高仙平臺的 OPENAPI，完成實際數據獲取。
這一層對前端透明，前端無須關心高仙 API 的調用、鑒權等問題。
三、接口 URL 是否會混亂？
前端和后端使用相同的 URL（如
/external/gs/map/robotMap/list）并不會混亂。前端是請求方，后端是服務方，職責清晰。
前端只需要知道“向哪個地址要數據”，后端負責實現這個地址的處理邏輯。
高仙OPENAPI只是后端訪問的外部服務，對前端不可見。
四、為什么要通過后端中轉？
安全性：避免將第三方 API 的密鑰和簽名暴露給前端。
靈活性：后端可統一處理異常、格式轉換、權限控制、緩存等業務邏輯。
解耦合：前端無需直接適配第三方 API，只需適配自家后端接口，降低維護難度。
五、整體流程圖
前端|| 1. 請求 /external/gs/map/robotMap/listv
后端|| 2. 調用高仙OPENAPI獲取數據v
高仙OPENAPI|| 3. 返回數據給后端v
后端|| 4. 返回整理后的數據給前端v
前端
六、總結
前后端分離項目中，建議采用統一的接口約定、分層設計，前端調用自家后端接口，后端根據需要再與第三方平臺（如高仙）對接。這種方式有效提升了安全性、可維護性和系統靈活性。
)
