电力视觉云边端协同计算应用平台接口规范.pdfVIP

附录A

（资料性）

电力视觉云边端协同计算应用平台接口规范

A.1登陆样本平台接口

1.登陆页面接口

接口路由地址/api/auth/login

验证用户提交的身份信息，返回身份令牌token，用于后续操作的

接口功能

权限校验

account（string）：账号

password（string）：密码

参数captchaCode（string）：图形验证码

captchaToken（string）：图形验证码标识

deviceId（string）：登录设备唯一标识

Integer状态码

返回String提示信息是否登陆成功

Object成功时返回身份令牌（token）及其它数据

2.登陆页面身份识别接口

接口路由地址/api/login/select-role-redirect

用户登录成功后，选择目标身份（角色），接口校验该身份是否为

接口功能用户已拥有的权限，返回对应页面跳转地址，实现“主动选择+权限

控制”的定向访问。

token（string）：登录成功后获取的身份令牌（用于验证当前登

录状态及用户身份）

参数

selectedRole（string）：用户选择的目标角色标识

clientType（string）：客户端类型

Integer状态码

String提示信息是否登陆成功

返回String实际生效的角色标识

String角色对应的跳转页面地址

Array该角色拥有的核心权限列表

11

A.2样本训练模型接口

1.样本进行样本训练接口

接口路由地址/api/model/train/trigger

接收标注完成的样本数据（或样本集），校验数据格式、完整性后，

接口功能触发模型训练任务，返回训练任务ID及状态，实现样本到训练的自动

化衔接

sampleSetId（String）样本集唯一标识，对应已标注的样本集合，

用于关联数据库中的样本数据

modelId（String）待训练的模型

trainParams（Object）训练参数配置

trainParams.epoch（Integer）训练轮次

参数

trainParams.learningRate（Float）学习率

trainType（String）训练类型：full（全量训练，默认）、incremental

（增量训练，基于上一轮模型继续训练）

parallelConfig（Object）：混合并行配置，如冻结策略、并行