OpenAPI扩展插件：API参数预处理

变更记录

产品版本	更新内容	更新日期
V5.0.014	初始版本	2023年1月
V6.0.8	扩展插件支持自定义查询操作API的出参排序	2024年4月

1 简介

1.1 功能介绍

OpenAPI支持在操作API中注册扩展插件，实现通过插件对查询、提交、审核等操作API的请求参数进行过滤，以及在保存API中通过插件进行入参的预处理。

1.2 应用场景

OpenAPI插件扩展可以根据业务场景定制化API的请求参数，不需要对整个API进行修改，降低开发成本，提升开发效率。

1.3 系统路径

【开放服务云】→【OpenAPI】→【API管理】 →【API开发】

2 主要操作

进行系统集成时，通过OpenAPI零代码配置的操作API，若过滤条件不满足实际业务需求，可通过编写插件自定义过滤条件，来扩展查询API的功能。

上传图片

2.1 编写插件代码

不同操作插件类需要实现不同的接口，如下表：

操作类型	实现接口
查询	kd.bos.openapi.api.plugin.ApiQueryPlugin
保存	kd.bos.openapi.api.plugin.ApiSavePlugin
提交	kd.bos.openapi.api.plugin.ApiSubmitPlugin
反提交	kd.bos.openapi.api.plugin.ApiUnSubmitPlugin
审核	kd.bos.openapi.api.plugin.ApiAuditPlugin
反审核	kd.bos.openapi.api.plugin.ApiUnAuditPlugin
删除	kd.bos.openapi.api.plugin.ApiDeletePlugin
启用	kd.bos.openapi.api.plugin.ApiEnablePlugin
禁用	kd.bos.openapi.api.plugin.ApiDisablePlugin
非以上其他操作	kd.bos.openapi.api.plugin.ApiCommonPlugin

表 1 插件可实现接口

在插件中实现查询的接口，并重写getFilter方法，其中方法参数filter为原接口的过滤条件， reqData为原接口的请求入参。处理逻辑是返回一个新的过滤条件，即覆盖原过滤条件。

import kd.bos.openapi.api.plugin.ApiQueryPlugin;
public class DemoApiQueryPlugin implements ApiQueryPlugin {
  @Override
  public QFilter getFilter(QFilter filter, Map<String, Object> reqData) {
    return new QFilter("billstatus", QCP.equals, "B")
        .and(new QFilter("creator.name", QCP.equals, "fjp"));
  }
}

2.2 注册并启用插件

在API详情页面中找到扩展插件，注册并启用插件。

上传图片

2.3 API在线测试

点击“API测试”按钮，实时调试API功能。若插件正常执行，则返回参数会根据新的过滤条件进

OpenAPI扩展插件：API参数预处理

变更记录

2.1 编写插件代码

2.2 注册并启用插件

2.3 API在线测试

OpenAPI扩展插件：API参数预处理

相关阅读

栏目

最新发布

热门标签