jvs-rules API数据源配置说明（含配置APIdemo视频）

在JVS中，多数据源支持多种形态的数据接入，其中API是企业生产过程中常见的数据形态。使用数据源的集成配置，以统一的方式管理和集成多个API的数据。这些平台通常提供各种数据转换和处理功能，使得从不同数据源获取和处理数据变得更加简单和高效。文章末尾附有规则引擎配置API的demo视频。

API数据源界面介绍

下图展示在多数据源下的API配置界面，其中包括左侧的API数据源管理，右侧展示配置详情

①：表示数据方，往往数据方可能提供多个API接口

②：表示在左侧数据方提供的接口明细

③：数据方配置的基本信息

创建API数据源

选择API数据源目录上的“+”新增数据源按钮

系统进入添加API数据源配置界面，如下图所示：

①：API数据源的基本名称，一般常用于数据提供方的记录，表示数据提供的来源，一般同一个数据源有多个数据接口

②：选择jar，这里选择jar包是一个可选项，如果这个接口访问有特殊的业务处理逻辑，可以通过独立的jar包实现复杂定制化的业务逻辑

③：静态请求头的参数配置，如果配置，那么本数据方下的所有接口请求头都会携带该配置数据项

完成数据方配置后，系统将在左侧菜单上形成对应数据方的记录。

数据接口连接配置

在完成数据方的配置后，可以增加这个数据提供方下的接口，如下图所示，点击添加

选中对应数据方，进入接口列表管理页面， 点击添加按钮，进入接口配置界面

①：展示了配置api需要两个步骤，第一步配置api的连接配置，第二步完成数据解析的设置

②：设置接口的名称

③：设置该接口请求的方式，post/get

④：设置请求回来数据是否存在分页的情况，如果存在开启分页设置

⑤：设置入参请求参数

⑥：其他参数主要用于通过jar进行数据特殊处理时所需要的参数

• 填写 API 数据表的基础信息，包括名称、完整的请求地址和请求方式，请求方式支持 GET 和 POST；
• 如果开启分页设置，系统会展示分页数量，分页数量默认“-1”表示无限制，可以对端接口具体要求设置单页多少条，另外系默认新增两个入参字段，size（单页多少条）与current（当前第几页）

参数设置，参数包括参数名称，字段展示名称，字段的类型，必填标志，参数使用的场景等（路径、请求头、请求体）

数据结果提取配置

在完成接口连接配置后，可以点击下一步按钮，系统进入提取数据结果的配置

进入结果提取配置界面如下图所示：

①：展示接口配置进展情况

②：获取指定json格式的业务结果（如果无法在线获取对端返回结果的情况下使用）

③：接口获取数据成功的状态数据

④：返回数据中，使用者关注的数据

⑤：展示返回回来的数据结果

⑥：以json的方式预览数据结果

API接口自定义JAR包管理

对于api需要自定义处理业务逻辑的情况下，通常采用自定义jar包的方式进行处理，一般下列情况下可能都采用自定义jar

• 具备有效期的动态token
• 参数传递不规范
• 返回值具有特殊加解密
• 特殊数据脱敏处理
• 来回多次交互

jar包管理页面管理入口如下图所示：

点击设置，进入jar包管理界面，jar包管理包括增删改，如下图所示

​​点击查看jvs-rules规则引擎配置API操作​​