前后端分离项目中的接口设计与调用流程——以高仙机器人集成为例
一、背景介绍
在前后端分离项目开发中，前端页面需要频繁调用后端接口获取数据。在高仙机器人对接项目中，我们采用了若依（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
前端
六、总结
前后端分离项目中，建议采用统一的接口约定、分层设计，前端调用自家后端接口，后端根据需要再与第三方平台（如高仙）对接。这种方式有效提升了安全性、可维护性和系统灵活性。